Geocontext

🚀 geocontext

実験的なMCPサーバーで、LLMに空間コンテキストを提供します。

🚀 クイックスタート

このサーバーは、LLMに空間データのコンテキストを提供するための実験的なMCPサーバーです。以下のセクションでは、その詳細な使用方法や機能について説明します。

✨ 主な機能

空間サービスの利用

地理プラットフォームのいくつかのサービスを利用できます。

• geocode(text) は、地理プラットフォームの自動補完サービス を使用して、場所の名前を位置 (経度, 緯度) に変換 します。

例: ヴァンセンヌ市役所の位置 (経度, 緯度) は何ですか?

• altitude(lon,lat) は、地理プラットフォームの標高計算サービス を使用して、位置を標高に変換 します。

例: ロレー市役所 (25) の標高は何ですか?

場所に関する情報の検索

地理プラットフォームのWFSサービスへの呼び出しをサーバー側で処理し、具体的な質問に回答します。

• adminexpress(lon,lat) は、与えられた位置の場所に関する 行政情報 (市、県、地域など) を取得します。

例: ヴァンセンヌ市役所の行政情報は何ですか?

• cadastre(lon,lat) は、地籍情報 (区画、地図番号など) を取得します。

例: ヴァンセンヌ市役所の地籍情報は何ですか?

• urbanisme(lon,lat) は、都市計画情報 (PLU、POS、CC、PSMV) を取得します。

例: マルセイユ港で有効なPLU文書は何ですか?

• assiette_sup(lon,lat) は、公共用役地 (SUP) を取得します。

ベクターデータの探索

テーブルの探索

• gpf_wfs_list_types() は、地理プラットフォームのWFSで利用可能な テーブルを一覧表示 します (GetCapabilities) - 非推奨 (結果が多すぎます)
• gpf_wfs_search_types(keywords,max_results=10) は、地理プラットフォームのWFSで利用可能な テーブルを検索 します (GetCapabilities)

• 地理プラットフォームで利用可能なADMINEXPRESSの年度は何ですか?
• BDTOPOの建物に対応するテーブルは何ですか?
• BDTOPOのどのテーブルで橋を見つけることができますか?

テーブル構造の探索

• gpf_wfs_describe_type(typename) は、テーブルのスキーマを取得 します (DescribeFeatureType)

• ADMINEXPRESS-COG.LATESTで市に関して利用可能な情報は何ですか?
• ADMINEXPRESS-COG:2024とADMINEXPRESS-COG.LATESTの市のモデルを比較してください

テーブルデータの探索

• gpf_wfs_get_features(typename,...) は、テーブルのデータを取得 します (GetFeature)

• ドゥーブ県 (25) で最も人口の多い5つの市はどれですか?
• エッフェル塔から5km以内にある建物はいくつありますか?

📦 インストール

公開バージョンの使用

例えば、"Cursor Settings / MCP / Add server" を使用します。

{
  "mcpServers": {
    "geocontext": {
      "command": "npx",
      "args": ["-y", "@ignfab/geocontext"]
    }
  }
}

Dockerを使用した場合

docker compose build
docker compose up -d

その後、以下の設定を行います。

{
  "mcpServers": {
    "geocontext": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

💻 使用例

基本的な使用法

上記のインストール方法に従ってサーバーを起動し、LLMから空間サービスを呼び出すことができます。例えば、以下のような質問をすることができます。

Quelle est la position (lon,lat) de la mairie de Vincennes?

高度な使用法

高度な使用法については、各機能の説明を参照してください。例えば、特定のサービスを利用するための引数の指定方法などです。

📚 ドキュメント

モチベーション

LLMは、コンピューターで魔法が起こるかのような印象を与えますが、実際にはそうではありません。例えば、アシスタントが日付や時刻を知るためには、MCP time とインターフェースを接続する必要があります。同様に、ページを読むためには、MCP fetch と接続する必要があります。

地理データに関しては、ユーザーがアシスタントに住所の位置を知るような質問をすると、回答がもっともらしいが誤っている可能性が高いです。

技術的には、APICARTOのようなREST/GeoJSON APIを接続することは可能ですが、これらのAPIの設計は適していません (デフォルトで5000件の結果、応答に大きなジオメトリ、提供するジオメトリが複雑など)。

ここでのアイデアは、LLMが地理プラットフォームのデータとサービスにアクセスできるMCPの設計を実験する ことです。

注意事項

• この開発は、IgnFabとのインキュベーション中のPOCです (mborne/geocontext のアーカイブ中)
• これを産業化する必要があると判明した場合、リポジトリはIGNの責任で移行され、ツールは改名されます (例: IGNF/mcp-gpf-server)
• いくつかの問題や改善の可能性が特定されており、緩和/解決中です (c.f. issues)
• このツールは魔法ではありません (機能についての詳細は 機能 を参照してください)

設計原則

• 地理プラットフォームのデータをコピーしない (目的: サービスの改善点を特定すること、重複を避けること)
• 応答のサイズを最大限に制限する (目的: トークン数を最適化する、幻覚を避ける、ローカルモデルを使用できるようにする)
• ...

開発

ローカルバージョンの構築

git clone https://github.com/ignfab/geocontext
cd geocontext
npm install
npm run build

ローカルバージョンの使用

{
  "mcpServers": {
    "mcp-helloworld": {
      "command": "node",
      "args":["/chemin/absolu/vers/geocontext/dist/index.js"]
    }
  }
}

ローカルバージョンのデバッグ

npx -y @modelcontextprotocol/inspector node dist/index.js

パラメータ設定

高度な使用法のためのパラメータ設定です。

貢献

問題と機能要求

問題が発生した場合は、issueを作成 してください。以下の情報を提供することをお願いします。

• 使用したアシスタントとモデル
• アシスタントに対する要求 (例: "セーヌ川を渡る橋はいくつありますか?")

新機能の提案

以下の手順で新機能を提案してください。

• リポジトリをフォークする
• 新しいツールを作成する
• 自分でテストする
• プルリクエストを作成する

クレジット

• mcp-framework は、MCPの開発フレームワークを提供 します。

# 例えば、WMTSレイヤーのリストを公開する場合
mcp add tool gpf_wmts_layers

• @camptocamp/ogc-client は、WFS、WMTSなどのサービスのXML応答を読み取るために使用 されます。
• MiniSearch は、キーワード検索に使用 されます。
• jsts は、幾何学的処理 (例: 検索ポイントからの距離で応答をソートする) に使用されます。

🔧 技術詳細

本サーバーは、MCPフレームワークをベースに開発されており、地理プラットフォームの各種サービスと連携して空間データを提供します。各機能は、特定のツールを使用して実装されており、それぞれのツールは対応するサービスのAPIを呼び出しています。

📄 ライセンス

MIT