MCP Geocoder Rosetta

🚀 MCP 地理コーダーロゼッタプロジェクト

MCP 地理コーダーロゼッタプロジェクトは、様々なプログラミング言語と地理コーディングサービスで実装された MCP（機械学習制御プロトコル）地理コーディングツールに対し、統一的なインターフェースを提供することを目的としています。現在は以下の3種類の実装がサポートされています。

1. urllib ベースの Python 実装：Google Maps Geocoding API を直接呼び出します。
2. Google Maps SDK ベースの Python 実装：Google が提供する Python ライブラリを使ってやり取りします。
3. TypeScript 実装：Node.js プラットフォームで動作し、同様に Google Maps Geocoding API を呼び出します。

🚀 クイックスタート

📦 インストール

リポジトリのクローン

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-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": "あなたのAPIキー"
  }
}

Python の Google Maps SDK ベースの実装

"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": "あなたのAPIキー"
  }
}

Python の urllib ベースの実装

"GeocoderREST": {
  "command": "uv",
  "args": [
    "run",
    "--with",
    "mcp[cli]",
    "mcp",
    "run",
    "/path/to/mcp-gecoder-rosetta/python-urllib/gecoder.py"
  ],
  "env": {
    "GOOGLE_MAPS_API_KEY": "あなたのAPIキー"
  }
}

注意事項

⚠️ 重要提示

一度に1つの地理コーディング実装のみをインストールし、ツールの曖昧さの問題を避けてください。

💡 使用建议

• MCP ツールを設定する際は絶対パスを使用してください。
• JSON 設定の形式が正しいことを確認してください（末尾のカンマがなく、インデントが正しいこと）。

📄 ライセンス

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

🔧 技術詳細

一時ディレクトリの説明

リポジトリには複数の temp/ ディレクトリが含まれており、テストやデバッグ用のスクリプトを動的に生成するために使用されます。

• /temp/: 主要なテストスクリプト用のルート一時ディレクトリ。
• python-urllib/temp/: urllib 実装のテスト用スクリプト。
• python-googlemaps/temp/: Google Maps API 実装のテスト用スクリプト。
• typescript-googlemaps/temp/: TypeScript テストツール用。

これらのディレクトリは .gitignore に追加されているため、リポジトリにコミットしないでください。

既知の問題

• 対話型入力は非対話型環境（Claude Code など）ではうまく動作しません。
• 異なる実装間で性能と信頼性に差がある可能性があります。
• 古い MCP クライアント実装（mcp-client/）は廃止されており、維持管理されていません。