geo-mcp
🌍 geo-mcp
Claude(または任意のMCPクライアント)に、天気、ジオコーディング、タイムゾーン、周辺スポットといった現実世界のロケーション機能を提供する地理空間MCPサーバー。APIキーは一切不要です。
機能
Claude Desktop、Cursor、または任意のMCPクライアントを、5つのクリーンなツールを通じてライブ地理空間データに接続します:
ツール | 説明 | 使用API |
| 住所 → 緯度/経度 | Nominatim (OSM) |
| 緯度/経度 → 住所 | Nominatim (OSM) |
| 都市の現在の天気 | Open-Meteo |
| タイムゾーン + 現地時間 | timeapi.io |
| 半径内のPOI(地点) | Overpass (OSM) |
すべてのAPIは無料かつオープンであり、サインアップやキーの取得、個人利用におけるレート制限の心配はありません。
Related MCP server: Simple Weather MCP
クイックスタート
git clone https://github.com/yourname/geo-mcp
cd geo-mcp
pip install -r requirements.txt
python server.pyDockerで実行
docker build -t geo-mcp .
docker run -p 8000:8000 geo-mcpClaude Desktopへの接続
claude_desktop_config.json に以下を追加してください:
{
"mcpServers": {
"geo-mcp": {
"command": "python",
"args": ["/absolute/path/to/geo-mcp/server.py"]
}
}
}設定ファイルの場所:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Claude Desktopを再起動すると、🔨 ツールアイコンが表示されます。
プロンプト例
接続後、Claudeで以下を試してみてください:
What's the weather like in Tokyo right now?Find me hospitals within 500m of the Eiffel Tower.What time is it right now in lat 35.6762, lon 139.6503?Geocode "1600 Pennsylvania Ave NW, Washington DC"プロジェクト構造
geo-mcp/
├── server.py # FastMCP server + tool definitions
├── adapters/
│ ├── geocoding.py # Nominatim geocoder
│ ├── weather.py # Open-Meteo weather
│ ├── timezone.py # timeapi.io timezone
│ └── places.py # Overpass POI search
├── requirements.txt
├── Dockerfile
└── claude_desktop_config.jsonツールリファレンス
geocode_address(address: str)
{
"display_name": "Paris, Île-de-France, France",
"lat": 48.8566,
"lon": 2.3522,
"type": "city"
}current_weather(city: str)
{
"city": "London",
"temperature_c": 14.2,
"feels_like_c": 12.8,
"humidity_pct": 76,
"wind_speed_kmh": 18.4,
"condition": "Partly cloudy",
"precipitation_mm": 0.0
}places_nearby(lat, lon, category, radius_m)
サポートされているカテゴリ: restaurant, cafe, hospital, pharmacy, school, supermarket, park, hotel, bank, gas_station
{
"category": "cafe",
"count": 8,
"places": [
{ "name": "Monmouth Coffee", "lat": 51.513, "lon": -0.122, "opening_hours": "Mo-Fr 07:30-18:00" }
]
}このプロジェクトの目的
マルチアダプターMCPパターンを実証するために構築されました。これは、商用のフリート/テレマティクスMCPサーバーで使用されているものと同じアーキテクチャです。各アダプターは以下の特徴を持ちます:
個別にテスト可能
容易に入れ替え可能(NominatimをGoogle Mapsに、Open-MeteoをOpenWeatherに、など)
httpxを使用した非同期ファースト設計明確な戻り値スキーマによる型定義
これは、統一されたツールレイヤーの下で複数のベンダーAPIを接続する必要がある、現実世界のMCPサーバーのジョブに直接対応しています。
拡張
新しいデータソースを追加したい場合は、adapters/yourapi.py を作成してください:
import httpx
async def your_tool(param: str) -> dict:
async with httpx.AsyncClient() as client:
r = await client.get("https://api.example.com/...", timeout=10)
r.raise_for_status()
return r.json()次に、server.py に登録します:
from adapters.yourapi import your_tool
@mcp.tool()
async def exposed_tool_name(param: str) -> dict:
"""Tool description shown to the AI."""
return await your_tool(param)技術スタック
FastMCP — MCPサーバーフレームワーク
httpx — 非同期HTTPクライアント
Open-Meteo — 無料の天気API
Nominatim — OpenStreetMapジオコーディング
Overpass API — OpenStreetMap POIデータ
timeapi.io — タイムゾーン検索
ライセンス
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Geospatial MCP server for earthquake, tsunami, volcano, disaster, and FX data queries.
Hosted MCP server for Xweather weather data: conditions, forecasts, alerts, and more.
Geo MCP — geographic utilities from free public APIs
- APIVerveOAuthcom.apiverve
350+ production-ready APIs through one MCP server — weather, geocoding, validation, financial data.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides real-time weather data, hourly forecasts, and daily summaries using the free Open-Meteo API with no API key required. It enables users to search for weather conditions by specific coordinates or city names across multiple measurement units.2MIT
- AlicenseNot gradedqualityDmaintenanceA cross-platform MCP server that provides weather forecasts by coordinates, location name, or IP address without requiring API keys. It leverages Open Meteo and OpenStreetMap to deliver fast, single-query weather lookups.MIT
- AlicenseNot gradedqualityDmaintenanceMCP Server for global weather, forecasts, air quality, and climate data using Open-Meteo, no API key required.MIT
- AlicenseAqualityAmaintenanceA lightweight MCP server for Open-Meteo weather API, providing current weather, forecasts, location search, and more without requiring an API key.69 npmMIT