MCP Geocoder Rosetta

MCP地理編碼器多語言實現集合，提供Python和TypeScript的三種不同實現方式，作為開發者創建MCP工具的參考模板。

位置服務開發者工具 #地理編碼 #MCP協議 #多語言 #API工具 .Python

評分 : 2分

下載量 : 13

更新時間 : 2025-04-29

什麼是MCP Geocoder?

MCP Geocoder 是一個標準化的地理編碼工具，允許AI模型通過MCP協議調用外部服務（如Google Maps API）進行地址解析。它提供了多種語言實現，方便開發者集成。

如何使用MCP Geocoder?

用戶可以通過命令行或圖形界面輸入地址，服務器會返回對應的經緯度信息或其他地理位置數據。

適用場景

適合需要快速獲取地理位置信息的應用場景，例如物流配送、地圖標註等。

主要功能

多語言支持提供Python和TypeScript兩種語言實現，滿足不同開發需求。

Google Maps API集成無縫對接Google Maps API，支持高精度地理編碼服務。

MCP協議兼容遵循MCP標準協議，確保與其他AI系統的良好交互。

優勢與侷限性

優勢

易於集成到現有系統中

支持多種語言實現

提供詳細的錯誤處理機制

侷限性

需要有效的Google Maps API密鑰

某些環境可能需要手動配置依賴項

長時間運行的任務可能會遇到超時問題

如何使用

安裝依賴

確保已安裝Python 3.13+或Node.js 16+，並設置Google Maps API密鑰。

啟動服務器

在項目根目錄下運行測試腳本，檢查環境是否正常。

執行請求

使用命令行工具向服務器發送地址查詢請求。

使用案例

案例1：基礎地理編碼輸入地址後獲取其經緯度信息。

案例2：批量地址解析一次性處理多個地址查詢請求。

常見問題

為什麼需要設置Google Maps API密鑰？

如何解決模塊未找到的問題？

客戶端無法連接到服務器怎麼辦？

🚀 MCP 地理編碼器羅塞塔項目

MCP 地理編碼器羅塞塔項目致力於為採用不同編程語言和地理編碼服務實現的 MCP（機器學習控制協議）地理編碼工具打造一個統一的接口。它支持三種實現方式，能滿足多樣化的開發需求。

🚀 快速開始

安裝與配置

克隆倉庫

git clone git@github.com:yourusername/mcp-geocoder-rosetta.git
cd mcp-geocoder-rosetta

安裝依賴

Python 實現：

pip install googlemaps

TypeScript 實現：

npm install typescript @types/node @googlemaps/google-maps-services-js --save

配置環境變量

在項目根目錄下創建 .env 文件，並添加以下內容：

GOOGLE_MAPS_API_KEY=你的API密鑰

啟動實現

基於 urllib 的 Python 實現：

uv run --with mcp[cli] mcp run path/to/python-urllib/geocoder.py

基於 Google Maps SDK 的 Python 實現：

uv run --with mcp[cli] --with googlemaps mcp run path/to/python-googlemaps/gecoder.py

TypeScript 實現：

npx tsx path/to/typescript/googlemaps/gecoder.ts

✨ 主要特性

統一接口：為不同實現的 MCP 地理編碼工具提供統一接口。
多語言支持：涵蓋 Python 和 TypeScript 兩種編程語言的實現。
多方式調用：支持直接調用 Google Maps Geocoding API 和使用 Google Maps SDK 進行交互。

📦 安裝指南

克隆倉庫

git clone git@github.com:yourusername/mcp-geocoder-rosetta.git
cd mcp-geocoder-rosetta

安裝依賴

Python 實現：

pip install googlemaps

TypeScript 實現：

npm install typescript @types/node @googlemaps/google-maps-services-js --save

配置環境變量

在項目根目錄下創建 .env 文件，添加以下內容：

GOOGLE_MAPS_API_KEY=你的API密鑰

💻 使用示例

啟動不同實現

基於 urllib 的 Python 實現

uv run --with mcp[cli] mcp run path/to/python-urllib/geocoder.py

基於 Google Maps SDK 的 Python 實現

uv run --with mcp[cli] --with googlemaps mcp run path/to/python-googlemaps/gecoder.py

TypeScript 實現

npx tsx path/to/typescript/googlemaps/gecoder.ts

📚 詳細文檔

項目結構

python-urllib/：使用 urllib 和 Google Maps API 的 Python 實現。
python-googlemaps/：使用 Google Maps SDK 的 Python 實現。
typescript-googlemaps/：TypeScript 實現，通過 Node.js 平臺運行。
mcp-client/：舊的 MCP 客戶端實現（已棄用）。

集成到 Claude Desktop

添加 MCP 工具到配置

編輯 claude_desktop_config.json 文件，在 mcpServers 下添加以下內容：

TypeScript 實現

"GeocoderNode": {
  "command": "npx",
  "args": [
    "tsx",
    "/path/to/mcp-gecoder-rosetta/typescript-googlemaps/gecoder.ts"
  ],
  "env": {
    "GOOGLE_MAPS_API_KEY": "your-api-key-here"
  }
}

基於 Google Maps SDK 的 Python 實現

"GeocoderGoogle": {
  "command": "uv",
  "args": [
    "run",
    "--with",
    "mcp[cli]",
    "--with",
    "googlemaps",
    "mcp",
    "run",
    "/path/to/mcp-gecoder-rosetta/python-googlemaps/gecoder.py"
  ],
  "env": {
    "GOOGLE_MAPS_API_KEY": "your-api-key-here"
  }
}

基於 urllib 的 Python 實現

"GeocoderREST": {
  "command": "uv",
  "args": [
    "run",
    "--with",
    "mcp[cli]",
    "mcp",
    "run",
    "/path/to/mcp-gecoder-rosetta/python-urllib/gecoder.py"
  ],
  "env": {
    "GOOGLE_MAPS_API_KEY": "your-api-key-here"
  }
}