RuralCheck

RuralCheck MCP 服务

此服务可让 AI Agent 使用 RuralCheck 分析欧洲乡村土地地块。你可以询问 Claude、ChatGPT 或任何其他 MCP 客户端：某块田地是否会被水淹、道路噪音有多大、房屋在 1 月能晒到几小时的太阳，或者该地块对应哪个土地登记地块。Agent 会调用 RuralCheck，并返回计算出的数据及其来源。

可以回答的问题

一份报告由一组检查项组成。你只需选择需要的检查项，每项都会返回相应数据、注意事项及数据来源。

分组	检查项
视野	视野延伸多远，以及能看到什么
周边地区	最近的村庄和城镇、附近人口、商店和服务设施、水域、应急服务、驾车时间、当地经济、游客、附近房产销售、城镇网站、狩猎
滋扰因素	道路和铁路噪音、飞机、滋扰、叮咬和蜇伤、野生动物、入室盗窃
地块	土地登记、地块上的路径、自治市、规划分区、当地规定、购置税、年度房产税、地形、保护区
天气和气候	天气、日照、风、降雪、夜空、空气质量、2050 年气候
风险	洪水、沿海洪水、野火、滑坡、雪崩、地震、白蚁和干腐
基础设施	太阳能板、地下水、用水限制、互联网
植被	树木、花粉、当地可种植的植物
交通	公共交通、道路通行

list_checks 会返回当前检查项列表，以及每项检查的范围、耗时和免费套餐是否支持运行该检查。

每个数值均根据官方数据得出。报告不构成土地测量、估价或法律建议。报告覆盖欧洲地面测量足够精细的地区；check_coverage 会说明某个地点是否位于覆盖范围内。

工具

每个工具都需要 RuralCheck 账户。免费套餐可运行免费检查，限制与地图上的相同；付费套餐可运行所有检查。一个账户每分钟可通过 analyse_plot 启动一份新报告。使用 get_report 获取报告不计入此限制。每分钟启动多份报告需要定制方案。

这里的任何操作都不会永久删除地块。删除的地块会移至账户的回收站，30 天后删除，或者在用户于网站上清空回收站时删除。

工具	功能
find_place	将村庄、城镇、地区、国家或邮政编码转换为坐标。对于区域，还会提供其范围以及是否可在当地生成报告。在挪威、比利时和丹麦可查找街道地址；其他地区则会将地址缩小到所属城镇。
check_coverage	检查某个点是否可进行分析，以及其地面测量的精细程度。
list_checks	列出所有检查，包括检查内容、所需时间，以及免费套餐是否可运行。
analyse_plot	对一个点运行指定的检查并返回结果。
get_report	获取等待时间超过一次工具调用的报告。
sample_report	提供一份多尔多涅河谷 4 ha 土地的真实完整报告，供你查看每项检查的返回内容。
upload_listings	专业套餐。发送 Agent 的房源信息：每条房源都会成为已保存的地块，包含完整报告和分享链接，并依次运行。
get_listing_upload	查看上传进度：每条房源的状态、分享链接，或未运行的原因。
list_listing_uploads	列出账户的上传记录及各自的进度。
list_plots	列出账户保存的地块及每项检查的关键数据。也可查看回收站。
get_plot	获取一个已保存地块的报告，内容为保存时的状态。
save_plot	将已完成的报告保存在“我的地块”中。仅当报告运行了套餐中的所有检查时才能保存。
update_plot	重命名已保存的地块或替换其备注。
file_plot	将已保存的地块放入文件夹，或从文件夹中移出。
delete_plot	将已保存的地块移至回收站。可在 30 天内恢复。
restore_plot	将地块从回收站中移出。
list_folders	列出账户的文件夹。
create_folder, rename_folder	创建或重命名文件夹。
delete_folder	删除文件夹。其中的地块会保留，但不归属于任何文件夹。

回答以文本形式返回 JSON：包含数据、注意事项，以及数据来源的署名信息。不包含地图轮廓和图片。

使用方法

托管服务

服务地址为 https://ruralcheck.eu/mcp。它通过 OAuth 为你登录，因此 Claude 和 ChatGPT 只需要此地址：

• Claude：依次选择 Customize、Connectors、+、Add custom connector，输入地址，然后选择 Connect，并在 RuralCheck 页面上授权。
• ChatGPT：在 Settings 的 Security and login 下开启 Developer mode。然后打开 Plugins，选择 +，输入地址，并在 RuralCheck 页面上授权。

支持设置请求头的客户端也可以改用账户页面中的 API 密钥。在 Claude Code 中：

claude mcp add --transport http ruralcheck https://ruralcheck.eu/mcp \
  --header "Authorization: Bearer $RURALCHECK_API_KEY"

在自己的机器上

Python 3.10 或更高版本。使用 uv：

uvx --from git+https://github.com/cmosig/ruralcheck-mcp ruralcheck-mcp

Claude Desktop、Cursor 和大多数其他客户端都可以使用类似这样的配置块：

{
  "mcpServers": {
    "ruralcheck": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/cmosig/ruralcheck-mcp", "ruralcheck-mcp"],
      "env": { "RURALCHECK_API_KEY": "rc_..." }
    }
  }
}

ruralcheck-mcp --http --port 8765 提供可流式传输的 HTTP，而不是 stdio，并在其前面进行 OAuth 登录。没有令牌的请求会收到 401 响应，其中指向 /.well-known/oauth-protected-resource/mcp，该地址指定 ruralcheck.eu 为授权服务。客户端返回的令牌是普通 API 密钥。服务端不会保存任何令牌：它会使用 API 验证每个令牌，并将其传递下去。

变量	默认值	含义
RURALCHECK_API_KEY	无	你的密钥，用于 stdio。必需。
RURALCHECK_BASE_URL	https://ruralcheck.eu	API 所在地址。
RURALCHECK_WAIT_S	45	一次工具调用等待报告的时长，超时后返回一个 ID。
RURALCHECK_PUBLIC_URL	https://ruralcheck.eu	托管服务的访问地址，用于其 OAuth 元数据。
RURALCHECK_AUTH_URL	公共 URL	OAuth 授权服务。

署名

每个回答背后的数据均以要求注明来源的许可证发布。每份报告都包含一个 attribution 列表。请向阅读结果的人展示该列表。

开发

python -m venv .venv && .venv/bin/pip install -e . pytest
.venv/bin/python -m pytest

tests/test_server.py 使用模拟 API 运行，无需网络。tests/test_live.py 会针对真实实例调用每个工具，只有在设置了 RURALCHECK_LIVE_URL 和 RURALCHECK_API_KEY 时才会运行。每当 API 发生变化时，都要运行此测试。

API 契约位于 ruralcheck.eu 的 /api/v1/ 下：checks、coverage、search、sample、带有长轮询 ?wait= 和 ?drawing=false 的 reports，以及用于“我的地块”的 plots 和 folders。

许可证

本仓库中的代码采用 MIT 许可证。获取的报告受 RuralCheck 条款以及每份报告 attribution 中列出的许可证约束。