用途
geomelon-mcp 是 Geomelon 地理 API 的 MCP（Model Context Protocol）服务器，用于向任意兼容 MCP 的 AI 客户端暴露城市、国家、地区和多语言名称等地理数据。用户可以通过 AI 客户端调用这些工具，完成地点相关的查询与自动补全。
主要能力
- 暴露城市、国家、地区、语言的工具，以及带多语言名称的地点数据。
- 提供地点自动补全（place autocomplete）。
- 包含两种传输方式：stdio 与远程 HTTP。
- 无密钥演示模式：没有 GEOMELON_API_KEY 时也可启动，仅启用 search_cities_autocomplete 工具，由免费 oneshot 主机支持，无需注册。其余工具均需要 RapidAPI 密钥。
- 完整工具集共 22 个；部分工具会在内部串联多次 API 调用，以减少往返次数。
- Geomelon 还提供该无密钥演示的公共托管实例，无需 npx 或本地进程即可使用，同样仅暴露 search_cities_autocomplete。
- 官方库列表位于 geomelon.dev/libraries，供其他集成方式参考。
使用方式
Claude Code（HTTP）
- 在将要运行服务器的目录中创建 .env 文件。
- 启动服务器（dotenv 会自动加载 .env）。
- 使用 claude mcp add 命令注册到 Claude Code。
- 验证连接状态。 注意：使用 Claude Code 时服务器必须保持运行。如需更换端口，设置 PORT=your_port，并相应更新 claude mcp add 命令中的 URL。
Claude Desktop（stdio）
将配置添加到 ~/Library/Application Support/Claude/claude_desktop_config.json，保存后重启 Claude Desktop。
Cursor / Windsurf / Cline（stdio）
添加到对应编辑器的 MCP 配置中。
远程 / 托管 HTTP 服务器
- 在服务器上创建 .env 文件。
- 启动服务器。
- 使用
http://your-host:3000/mcp作为 URL，注册到任意 MCP 客户端。 该 HTTP 传输是无状态的：每个请求相互独立，无需会话管理。CORS 完全开放（Access-Control-Allow-Origin: *），因为该传输也面向基于浏览器的远程 MCP 客户端。GET /（或 /health）返回一个小的 JSON 状态对象，可用于运行状态检查，并报告实例是否已配置密钥（"mode": "full"或"mode": "keyless-demo"）。
可用工具
- Oneshot 前缀搜索（免费，无需 API key）。支持的国家/语言对及底层 HTTP 端点参见 geomelon.dev/free-city-autocomplete-api。
- 其他工具需要 RapidAPI 密钥；这些工具会在内部串联多次 API 调用以节省往返。
适用场景
- 需要让兼容 MCP 的 AI 客户端访问城市、国家、地区、语言等地理数据。
- 需要地点自动补全能力。
- 希望在本地或远程部署一个地理数据 MCP 服务器。
限制
- 无密钥演示模式仅提供 search_cities_autocomplete 一个工具，其余工具需要 RapidAPI 密钥。
- 公共托管实例同样只暴露 search_cities_autocomplete；要使用完整的 22 个工具，需要运行自己的实例并配置 RapidAPI 密钥。
- HTTP 传输无状态，CORS 完全开放。
- 关于具体工具的参数、返回格式、调用示例、定价、速率限制等细节，资料暂未提供。
