RuralCheck

RuralCheck MCP サーバー

このサーバーを使うと、AI エージェントが RuralCheck でヨーロッパの田園地帯にある土地を分析できます。Claude、ChatGPT、その他の MCP クライアントに、畑が浸水するか、道路の騒音はどの程度か、1月に家に何時間日が差すか、土地登記上の区画はどれかを尋ねられます。エージェントは RuralCheck を呼び出し、出典付きの計算結果を受け取ります。

回答できる内容

レポートは複数のチェックで構成されます。必要なものだけを尋ねると、それぞれ数値、注意事項、情報源とともに返されます。

グループ	チェック項目
景観	見晴らしの距離と、視界に入るもの
地域	最寄りの村や町、近隣の人口、店舗やサービス、水域、緊急サービス、車での所要時間、地域経済、観光客、近隣の売却物件、町のウェブサイト、狩猟
騒音・迷惑事	道路や鉄道の騒音、航空機、迷惑事、刺咬被害、野生動物、空き巣
土地	土地登記、敷地内の小道、自治体、用途地域、現地の規則、購入時の税金、年間の固定資産税、地形、保護区域
天候と気候	天候、日照、風、雪、夜空、大気質、2050年の気候
リスク	洪水、沿岸洪水、山火事、地滑り、雪崩、地震、シロアリや乾腐
インフラ	ソーラーパネル、地下水、水の使用制限、インターネット
植生	樹木、花粉、現地で育つもの
アクセス	公共交通機関、アクセス道路

list_checks は、各チェックの対象、所要時間、無料プランで実行できるかを含む現在の一覧を返します。

すべての数値は公的データから算出されます。レポートは土地測量、査定、法的助言ではありません。対象となるのは地面が十分に詳細に測量されているヨーロッパの地域であり、check_coverage で対象地点かどうかを確認できます。

ツール

すべてのツールで RuralCheck アカウントが必要です。無料プランでは無料のチェックを実行でき、マップと同じ上限が適用されます。有料プランではすべてのチェックを実行できます。アカウントで analyse_plot を使って新しいレポートを開始できるのは、1 分に 1 件です。get_report でレポートを取得する場合は、この上限にカウントされません。1 分に 1 件を超える場合は Custom solution が必要です。

ここにある機能で、区画が完全に削除されることはありません。削除した区画はアカウントのゴミ箱に移動し、30 日後、またはユーザーがウェブサイトでゴミ箱を空にしたときに削除されます。

ツール	機能
find_place	村、町、地域、国、郵便番号から座標を検索します。地域の場合は、その範囲とレポートが作成される地域かどうかも返します。ノルウェー、ベルギー、デンマークでは番地まで検索でき、それ以外の国では町までの検索となります。
check_coverage	ある地点を分析できるかどうか、および地面をどの程度細かく測定するかを確認します。
list_checks	すべてのチェックについて、対象、所要時間、無料プランで実行できるかどうかを表示します。
analyse_plot	指定した地点について、指定したチェックを実行し、結果を返します。
get_report	1 回のツール呼び出しの待ち時間を超えて処理されたレポートを取得します。
sample_report	ドルドーニュ渓谷の 4 ha の土地に関する、各チェックの結果を確認できる実際の完全なレポートです。
upload_listings	プロフェッショナルプラン。エージェントの物件情報を送信します。各物件情報は、完全なレポートと共有リンクを持つ保存済みの区画となり、順番に処理されます。
get_listing_upload	アップロードの進捗を表示します。各物件情報のステータス、共有リンク、または処理されなかった理由を確認できます。
list_listing_uploads	アカウントのアップロードと、それぞれの進捗を表示します。
list_plots	アカウントに保存されている区画と、各チェックの主な数値を表示します。ゴミ箱の内容も表示できます。
get_plot	保存時点のレポートを含む、保存済みの区画を 1 件取得します。
save_plot	完了したレポートを「My plots」に保存します。プランに含まれるすべてのチェックを実行したレポートのみ保存できます。
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 は stdio の代わりにストリーミング可能な HTTP を提供し、その前段に OAuth サインインを配置します。トークンなしのリクエストには、認可サーバーとして ruralcheck.eu を指定する /.well-known/oauth-protected-resource/mcp を示す 401 が返されます。クライアントが受け取るトークンは、通常の API キーです。サーバーはトークンを保存せず、API で各トークンを検証して、そのまま渡します。

変数	デフォルト	意味
RURALCHECK_API_KEY	なし	stdio 用のキーです。必須です。
RURALCHECK_BASE_URL	https://ruralcheck.eu	API の URL です。
RURALCHECK_WAIT_S	45	レポートの ID を返すまで、1 回のツール呼び出しが待機する時間です。
RURALCHECK_PUBLIC_URL	https://ruralcheck.eu	ホストされたサーバーにアクセスする URL です。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、および My plots 用の plots と folders が含まれます。

ライセンス

このリポジトリのコードは MIT ライセンスです。取得するレポートには RuralCheck の規約と、各レポートの attribution に記載されたライセンスが適用されます。