Ign Apicarto MCP Server

🚀 IGN API Carto MCP Server

このサーバーは、Claude Desktopやその他のMCP互換クライアントから、直接IGN (Institut national de l'information géographique et forestière) の豊富な地理データにアクセスできるようにします。IGN API Cartoエコシステムの主要なAPIを公開し、自然言語でフランスの地籍、農業、環境、都市計画、行政データを照会できます。

🚀 クイックスタート

このサーバーを使用することで、Claude Desktopやその他のMCP互換クライアントから、自然言語でフランスの地理データにアクセスできます。以下の手順でセットアップしてください。

✨ 主な機能

利用可能なツール

📦 インストール

1. リポジトリをクローンする

git clone https://github.com/votre-utilisateur/ign-apicarto-mcp-server.git
cd ign-apicarto-mcp-server

2. 依存関係をインストールする

npm install

3. 環境変数を設定する

# サンプルファイルをコピー
cp .env.example .env.local

.env.local を編集し、ワイン産地名称のエンドポイントを使用する場合は、IGNのAPIキーを追加します。

# 無料のAPIキーを取得する: https://geoservices.ign.fr/
IGN_API_KEY=votre_cle_api

4. プロジェクトをコンパイルする

npm run build

コンパイルされたサーバーは dist/ ディレクトリに配置されます。

📚 ドキュメント

コンフィギュレーション

このMCPサーバーをお使いの好みのAIクライアントで設定します。使用しているクライアントをクリックして、詳細な手順を表示します。

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

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

{
  "enableAllProjectMcpServers": true
}

{
  "enabledMcpjsonServers": ["ign-apicarto"]
}

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

{
  "mcpServers": {
    "ign-apicarto": {
      "command": "node",
      "args": ["${workspaceFolder}/ign-apicarto-mcp-server/dist/index.js"],
      "env": {}
    }
  }
}

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

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

{
  "mcpServers": {
    "ign-apicarto": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

TRANSPORT=http PORT=3000 npm start

トランスポートモード

サーバーは、2つの通信モードをサポートしています。

stdioモード (デフォルト)

Claude Desktopでのローカル使用に適した標準モードです。

npm start

HTTPモード (オプション)

ネットワークでの使用またはリモートクライアントからの使用に適しています。

TRANSPORT=http PORT=3000 npm start

環境変数

サーバーは、.env.local ファイルまたは直接コマンドラインで設定できます。

設定ファイル :

• .env.example : 利用可能なすべての変数を含むテンプレート
• .env.local : ローカル設定 (バージョン管理されません)

利用方法

Claude Desktopで設定した後は、自然言語でIGNのデータを照会できます。サーバーは自動的にあなたのクエリを適切なAPI呼び出しに変換します。

設定後の再起動

claude_desktop_config.json を変更した後は、Claude Desktopを再起動して変更を反映させてください。

💻 使用例

1. 郵便番号による検索

質問 :

郵便番号75001に関連付けられたコミューンはどれですか？

期待される回答 :

• INSEEコード付きのコミューンのリスト
• 地理座標
• 行政境界

使用するツール : ign_get_communes_by_postal_code

2. 地籍区画の検索

質問 :

INSEEコード75101のコミューンの地籍区画を見つけてください

可能なパラメータ :

• コミューンのINSEEコード
• 地籍区画
• 区画番号

使用するツール : ign_get_cadastre_parcelles

3. 都市計画区域の確認

質問 :

これらの座標 : {"type":"Point","coordinates":[2.35,48.85]} のPLU区域は何ですか？

返される情報 :

• 区域のタイプ (U、AU、A、N)
• 適用される都市計画規則
• 建築制限
• PLUの更新日

使用するツール : ign_get_gpu_urbanisme

4. 自然保護区域

質問 :

この点 : {"type":"Point","coordinates":[-1.69,48.10]} の近くにNatura 2000区域はありますか？

返される区域のタイプ :

• Natura 2000サイト (ZSC、ZPS)
• ZNIEFF (タイプIおよびII)
• 国立公園および地域公園
• 自然保護区

使用するツール : ign_get_nature_areas

5. 土地図形登録簿 (農業)

質問 :

2023年にこの農業区画で申告された作物は何ですか？
ジオメトリ : {"type":"Point","coordinates":[2.35,45.85]}

利用可能なデータ :

• 作物のタイプ
• 申告された面積
• PAC作物コード
• 申告年 (2010 - 2024)

使用するツール : ign_get_rpg

6. ワイン産地名称

注意 : このエンドポイントには、無料のIGN APIキーが必要です。 geoservices.ign.fr で取得してください。

質問 :

この区画はワイン産地名称 (AOC) の区域にありますか？
座標 : {"type":"Point","coordinates":[4.84,45.76]}

返される情報 :

• 産地名称のタイプ (AOC、IGP、VSIG)
• 産地名称
• 産地名称の識別子
• 区域のジオメトリ

使用するツール : ign_get_aoc_viticoles

必要な設定 :

# .env.local 内
IGN_API_KEY=votre_cle_api

7. 行政境界

質問 :

リヨンのコミューンはどの県と地域にありますか？

利用可能なデータ :

• コミューンの境界
• 県の輪郭
• 地域の輪郭
• 公式の地理コード

使用するツール : ign_get_administrative_limits

🔧 技術詳細

ジオメトリの形式

ジオメトリは、WGS84 (EPSG:4326) のGeoJSON形式である必要があります。

// 点
{"type":"Point","coordinates":[longitude, latitude]}

// ポリゴン
{"type":"Polygon","coordinates":[[[lon1,lat1],[lon2,lat2],[lon3,lat3],[lon1,lat1]]]}

// マルチポリゴン
{"type":"MultiPolygon","coordinates":[[[[lon1,lat1],[lon2,lat2],...]],[...]]}

制限事項

IGN APIの制限

機能的な制限

• ⚠️ WFS - 地理ポータルモジュールは ベータ 版です
• 一部のデータには更新遅延がある場合があります
• 複雑なジオメトリは単純化が必要な場合があります
• RPGデータは2010年から2024年まで利用可能です

データソース

開発

プロジェクト構造

ign-apicarto-mcp-server/
├── src/
│   ├── index.ts          # MCPサーバーのエントリポイント
│   ├── api-client.ts     # IGN APIのHTTPクライアント
│   └── types.ts          # TypeScriptの型定義
├── dist/                 # コンパイルされたファイル
├── .env.example          # 環境変数のテンプレート
├── .env.local            # ローカル設定 (バージョン管理されません)
├── .gitignore
├── package.json
├── tsconfig.json
└── README.md

利用可能なスクリプト

# 開発モードでサーバーを起動する
npm run dev

# プロジェクトをコンパイルする
npm run build

# 本番環境でサーバーを起動する
npm start

# テストを実行する (利用可能な場合)
npm test

# コードをチェックする
npm run lint

貢献する

貢献は大歓迎です！貢献するには：

1. プロジェクトをフォークします
2. 新しい機能のブランチを作成します (git checkout -b feature/AmazingFeature)
3. 変更をコミットします (git commit -m 'Add some AmazingFeature')
4. ブランチにプッシュします (git push origin feature/AmazingFeature)
5. プルリクエストを開きます

新しいツールを追加する

新しいMCPツールを追加するには：

1. src/tools/ に新しいファイルを作成します
2. ツールのスキーマとパラメータを定義します
3. IGN APIへの呼び出しのロジックを実装します
4. ツールを src/index.ts に登録します
5. このREADMEにツールをドキュメント化します

トラブルシューティング

サーバーが起動しない場合

確認事項 :

• Node.jsバージョン16以上がインストールされていることを確認します : node --version
• 依存関係がインストールされていることを確認します : npm install
• プロジェクトがコンパイルされていることを確認します : npm run build
• dist/index.js ファイルが存在することを確認します

Claude Desktopがサーバーを検出しない場合

解決策 :

1. claude_desktop_config.json 内のパスが絶対パスで正しいことを確認します
2. Claude Desktopを完全に再起動します
3. Claude Desktopのログを確認します :
   • macOS : ~/Library/Logs/Claude/
   • Windows : %APPDATA%\Claude\logs\
   • Linux : ~/.config/Claude/logs/

APIエラー

一般的な問題 :

ジオメトリの問題

ジオメトリは、緯度の前に経度を持つ WGS84 (EPSG:4326) である必要があります。

✅ 正しい : {"type":"Point","coordinates":[2.35, 48.85]}
❌ 誤った : {"type":"Point","coordinates":[48.85, 2.35]}

パフォーマンスが遅い場合

最適化策 :

• 大きな領域には単純化されたジオメトリを使用します
• _limit パラメータで結果の数を制限します
• 広範なクエリではなく、特定のフィルターを使用します
• インターネット接続を確認します

📄 ライセンス

このプロジェクトは MITライセンス の下で提供されています。詳細については、LICENSE ファイルを参照してください。

IGNデータ

IGNのデータは、Licence Ouverte v2.0 に準拠しています。

💡 このMCPサーバーを使用してプロジェクトを作成しましたか？ GitHubのissue を開いて共有してください！

参考資料

公式ドキュメント

• API Cartoのドキュメント - APIの完全なドキュメント
• IGNの地理サービス - 地理サービスのポータル
• Model Context Protocol - MCPの仕様
• Claude Desktop - Claude Desktopアプリケーション

便利なツール

• GeoJSON.io - GeoJSONジオメトリを作成して視覚化する
• Projections EPSG - 投影システムに関する情報
• 地理ポータル - IGNのデータを視覚化する

コミュニティ

• GitHubのIssues - バグを報告したり、機能を提案したりする
• ディスカッション - 質問をする

🥰 フランスの地理空間コミュニティのために開発されました