Opencage Geocoding MCP

🚀 OpenCage Geocoding MCP Server

このサーバーは、OpenCageジオコーディングAPIを使用してジオコーディング機能を提供するMCP（Model Context Protocol）サーバーです。 住所と地理座標の相互変換が可能です。

⚠️ 重要提示

ここに示す例は、claude.aiのデスクトップクライアントとの統合に基づいています。MCPは他のサービスでもサポートされていますが、設定が若干異なる場合があります。

✨ 主な機能

• 前方ジオコーディング：住所または場所名を座標（緯度/経度）に変換します。
• 逆ジオコーディング：座標を住所に変換します。
• APIステータス監視：APIの使用状況とレート制限を確認します（OpenCageアカウントにハード制限が設定されている場合）。

📦 インストール

前提条件

1. Node.js（バージョン20以上）
2. OpenCageジオコーディングAPIキー：OpenCageのウェブサイトでサインアップし、無料トライアルのジオコーディングAPIキーを取得してください。

手順

1. リポジトリをクローンし、リポジトリディレクトリに移動します。

git clone git@github.com:OpenCageData/opencage-geocoding-mcp.git
# または
git clone https://github.com/OpenCageData/opencage-geocoding-mcp.git

cd opencage-geocoding-mcp

2. 依存関係をインストールします。

npm install

これでClaude DesktopでMCPを動作させることができます（以下を参照）。

MCPを開発し、コマンドラインからMCPにクエリを送信する場合は、さらに以下の手順が必要です。 3. OpenCageジオコーディングAPIキーを環境変数として設定します。

export OPENCAGE_API_KEY="your_opencage_geocoding_api_key_here"

4. プロジェクトをビルドします。

npm run build

💻 使用例

Claude Desktop内での使用

Claude Desktopのコンフィグファイルに以下の設定を追加します。

Macの場合、コンフィグファイルは (~/Library/Application Support/Claude/claude_desktop_config.json) ですが、メニューから Settings > Developer > Edit Config を選択してファイルに移動することもできます。

{
  "mcpServers": {
    "opencage-geocoding": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/opencage-geocoding-mcp/build/index.js"],
      "env": {
        "OPENCAGE_API_KEY": "your_opencage_geocoding_api_key_here"
      }
    }
  }
}

利用可能なツール

初めてコマンドを実行する際には、Claudeに許可を与える必要があります。

1. geocode - forward

住所または場所名を座標とその場所に関する情報に変換します。

パラメーター

• query（必須）：ジオコーディングする住所または場所名
• countrycode（オプション）：国を制限する（ISO 3166 - 1 alpha - 2コード）
• bounds（オプション）：バウンディングボックス（min_lon,min_lat,max_lon,max_lat）
• language（オプション）：結果の言語（例：'en', 'de', 'fr'）
• limit（オプション）：最大結果数（1 - 100、デフォルト10）
• no_annotations（オプション）：場所の注釈を除外する

例のプロンプト

プロンプト: "What are the coordinates of Trafalgar Square, London?"
結果: 座標、タイムゾーン、現地通貨など

プロンプト: "Where is Les Vans, France? Which Department is it in?"
結果: 座標、およびLes VansがArdèche県にあるという正しい回答

プロンプト: "In welchem Bundesland liegt Weimar?"
結果: 座標、およびWeimarがThüringenにあるという正しい回答

2. geocode - reverse

座標を住所とその場所に関する情報に変換します。

パラメーター

• latitude（必須）：緯度座標（-90から90）、10進数形式
• longitude（必須）：経度座標（-180から180）、10進数形式
• language（オプション）：結果の言語
• no_annotations（オプション）：場所の注釈を除外する

例のプロンプト

プロンプト: "what is the address at 38.8976, -77.0365?"
結果: "1600 Pennsylvania Avenue NW, Washington, DC 20500, United States of America"

プロンプト: "Which province are the coordinates 41.38700, 2.16995 in?"
結果: "Coordinates are in Barcelona in the province of Catalonia"

3. get - opencage - info

現在のAPIの使用状況とレート制限を確認します。 注意：サブスクリプションの顧客にはハードな使用制限はありません。[関連ドキュメント](https://opencagedata.com/api#rate - limiting)を参照してください。

パラメーター：なし

戻り値：残りのリクエスト数、レート制限、およびリセット時間に関する情報。

利用可能なプロンプト

geocoding - assistant

ジオコーディングタスクに役立つアシスタントです。ジオコーディングツールを効果的に使用するためのガイダンスを提供します。

🔧 技術詳細

サーバーには包括的なエラーハンドリングが含まれています。

• 無効なAPIキー
• レート制限超過
• ネットワークエラー
• 無効な座標または住所
• APIサービス利用不可

環境変数

• OPENCAGE_API_KEY：OpenCageジオコーディングAPIキー（必須）

トラブルシューティング

1. "API key required"エラー：環境変数 OPENCAGE_API_KEY が設定されていることを確認してください。
2. "No results found"：より具体的なまたは異なる住所形式を試してみてください。[OpenCageのクエリフォーマットガイド](https://opencagedata.com/guides/how - to - format - your - geocoding - query)を参照してください。
3. レート制限エラー：get - api - status ツールでAPIの使用状況を確認してください。
4. ネットワークエラー：インターネット接続を確認するか、OpenCageの公開ステータスページを参照してください。

関連リンク

• OpenCageホームページ - ジオコーディングAPIキーを取得します。
• OpenCage APIドキュメント - 完全なOpenCageジオコーディングAPIリファレンス
• [OpenCage MCPチュートリアル](https://opencagedata.com/tutorials/geocode - inside - an - llm - via - mcp)
• Model Context Protocol - MCPについて詳しく学びます。

OpenCage GmbHとは？

当社は、オープンデータに基づく世界規模のジオコーディングAPIとジオサーチサービスを運営しています。 当社について詳しく学びましょう。

また、位置ベースのサービス作成者向けの定期的なミートアップシリーズであるGeomobを主催しています。ここでは、地理情報の革新をできる限り強調しています。地理情報が好きな方は、おそらくGeomobポッドキャストを楽しめるでしょう。