Geocoding By API Ninjas

# Geocoding By Api Ninjas MCP Server [English](./README_EN.md) | [简体中文](./README.md) | 繁體中文 用於存取 Geocoding By Api Ninjas API 的 MCP 伺服器。 ## 🚀 使用 EMCP 平台快速體驗 **[EMCP](https://sit-emcp.kaleido.guru)** 是一個強大的 MCP 伺服器管理平台，讓您無需手動配置即可快速使用各種 MCP 伺服器！ ### 快速開始： 1. 🌐 造訪 **[EMCP 平台](https://sit-emcp.kaleido.guru)** 2. 📝 註冊並登入帳號 3. 🎯 進入 **MCP 廣場**，瀏覽所有可用的 MCP 伺服器 4. 🔍 搜尋或找到本伺服器（`bach-geocoding_by_api_ninjas`） 5. 🎉 點擊 **「安裝 MCP」** 按鈕 6. ✅ 完成！即可在您的應用中使用 ### EMCP 平台優勢： - ✨ **零配置**：無需手動編輯配置檔案 - 🎨 **視覺化管理**：圖形介面輕鬆管理所有 MCP 伺服器 - 🔐 **安全可靠**：統一管理 API 金鑰和認證資訊 - 🚀 **一鍵安裝**：MCP 廣場提供豐富的伺服器選擇 - 📊 **使用統計**：即時查看服務調用情況 立即造訪 **[EMCP 平台](https://sit-emcp.kaleido.guru)** 開始您的 MCP 之旅！ --- ## 簡介 這是一個 MCP 伺服器，用於存取 Geocoding By Api Ninjas API。 - **PyPI 套件名**: `bach-geocoding_by_api_ninjas` - **版本**: 1.0.0 - **傳輸協定**: stdio ## 安装 ### 从 PyPI 安装: ```bash pip install bach-geocoding_by_api_ninjas ``` ### 从源码安装: ```bash pip install -e . ``` ## 运行 ### 方式 1: 使用 uvx（推荐，无需安装） ```bash # 运行（uvx 会自动安装并运行） uvx --from bach-geocoding_by_api_ninjas bach_geocoding_by_api_ninjas # 或指定版本 uvx --from bach-geocoding_by_api_ninjas@latest bach_geocoding_by_api_ninjas ``` ### 方式 2: 直接运行（开发模式） ```bash python server.py ``` ### 方式 3: 安装后作为命令运行 ```bash # 安装 pip install bach-geocoding_by_api_ninjas # 运行（命令名使用下划线） bach_geocoding_by_api_ninjas ``` ## 配置 ### API 認證 此 API 需要認證。請設定環境變數: ```bash export API_KEY="your_api_key_here" ``` ### 環境變數 | 變數名 | 說明 | 必需 | |--------|------|------| | `API_KEY` | API 金鑰 | 是 | | `PORT` | 不適用 | 否 | | `HOST` | 不適用 | 否 | ### 在 Cursor 中使用 編輯 Cursor MCP 配置檔案 `~/.cursor/mcp.json`: ```json { "mcpServers": { "bach-geocoding_by_api_ninjas": { "command": "uvx", "args": ["--from", "bach-geocoding_by_api_ninjas", "bach_geocoding_by_api_ninjas"], "env": { "API_KEY": "your_api_key_here" } } } } ``` ### 在 Claude Desktop 中使用 編輯 Claude Desktop 配置檔案 `claude_desktop_config.json`: ```json { "mcpServers": { "bach-geocoding_by_api_ninjas": { "command": "uvx", "args": ["--from", "bach-geocoding_by_api_ninjas", "bach_geocoding_by_api_ninjas"], "env": { "API_KEY": "your_api_key_here" } } } } ``` ## 可用工具 此服务器提供以下工具: ### `v1geocoding` API Ninjas Geocoding API endpoint. **端点**: `GET /v1/geocoding` **参数**: - `city` (string) *必需*: City name. - `state` (string): US state (for United States cities only). - `country` (string): Country name, 2-letter ISO country code, or 3-letter ISO country code. --- ### `v1reversegeocoding` API Ninjas Reverse Geocoding API endpoint. **端点**: `GET /v1/reversegeocoding` **参数**: - `lat` (number) *必需*: Latitude coordinate. - `lon` (number) *必需*: Longitude coordinate. --- ## 技術棧 - **傳輸協定**: stdio - **HTTP 客戶端**: httpx ## 授權 MIT License - 詳見 [LICENSE](./LICENSE) 檔案。 ## 開發 此伺服器由 [API-to-MCP](https://github.com/BACH-AI-Tools/api-to-mcp) 工具生成。 版本: 1.0.0