Opencage Geocoding MCP

🚀 OpenCage地理編碼MCP服務器

OpenCage地理編碼MCP服務器是一個運用 OpenCage地理編碼API 提供地理編碼功能的MCP（模型上下文協議）服務器。該服務器可讓你在地址和地理座標之間進行轉換。

請注意：此處展示的示例基於與 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

這樣就足以讓MCP與Claude桌面版一起工作（見下文）。

如果你想開發MCP並計劃從命令行查詢MCP，還需要： 3. 將你的OpenCage地理編碼API密鑰設置為環境變量：

export OPENCAGE_API_KEY="your_opencage_geocoding_api_key_here"

4. 構建項目：

npm run build

💻 使用示例

在Claude桌面版中使用

將以下配置添加到你的Claude桌面版配置文件中。

在Mac上，配置文件應為 (~/Library/Application Support/Claude/claude_desktop_config.json)，但你也可以通過菜單導航到該文件：設置 > 開發者 > 編輯配置。

{
  "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（可選）：邊界框（最小經度,最小緯度,最大經度,最大緯度）。
• language（可選）：結果的語言（例如，'en'、'de'、'fr'）。
• limit（可選）：最大結果數（1 - 100，默認10）。
• no_annotations（可選）：排除位置註釋。

示例提示：

提示："倫敦特拉法爾加廣場的座標是什麼？"
結果：座標、時區、當地貨幣等。

提示："法國的萊斯旺斯在哪裡？它在哪個省？"
結果：座標，並正確回答萊斯旺斯在阿爾代什省。

提示："魏瑪在哪個聯邦州？"
結果：座標，並正確回答魏瑪在圖林根州。

2. geocode-reverse

將座標轉換為地址以及該位置的相關信息。 參數：

• latitude（必需）：十進制格式的緯度座標（-90到90）。
• longitude（必需）：十進制格式的經度座標（-180到180）。
• language（可選）：結果的語言。
• no_annotations（可選）：排除位置註釋。

示例提示：

提示："38.8976, -77.0365的地址是什麼？"
結果："美國華盛頓特區賓夕法尼亞大道1600號，郵編20500"

提示："座標41.38700, 2.16995在哪個省？"
結果："座標位於加泰羅尼亞省的巴塞羅那"

3. get-opencage-info

檢查你當前的API使用情況和速率限制。 注意：訂閱用戶沒有嚴格的使用限制。請參閱 相關文檔。 參數：無 返回：有關剩餘請求數、速率限制和重置時間的信息。

可用提示

geocoding-assistant

一個用於地理編碼任務的有用助手。提供有效使用地理編碼工具的指導。

📚 詳細文檔

錯誤處理

服務器包含全面的錯誤處理：

• 無效的API密鑰
• 超出速率限制
• 網絡錯誤
• 無效的座標或地址
• API服務不可用

環境變量

• OPENCAGE_API_KEY：你的OpenCage地理編碼API密鑰（必需）

故障排除

1. “需要API密鑰”錯誤：確保環境變量 OPENCAGE_API_KEY 已設置。
2. “未找到結果”：嘗試使用更具體或不同的地址格式，參閱 OpenCage查詢格式指南。
3. 速率限制錯誤：使用 get-api-status 工具檢查你的API使用情況。
4. 網絡錯誤：驗證互聯網連接或查看 OpenCage公共狀態頁面。

相關鏈接

• OpenCage主頁 - 獲取你的地理編碼API密鑰。
• OpenCage API文檔 - 完整的OpenCage地理編碼API參考。
• OpenCage MCP教程
• 模型上下文協議 - 瞭解更多關於MCP的信息。

OpenCage GmbH是誰？

我們基於開放數據運行全球 地理編碼API 和 地理搜索 服務。瞭解更多 關於我們 的信息。

我們還組織 Geomob，這是一系列為基於位置的服務創建者舉辦的定期聚會，我們會盡力展示地理創新。如果你喜歡地理相關的內容，你可能會喜歡 Geomob播客。