用途
apogeoapi-mcp 是 ApogeoAPI 的 MCP（模型上下文协议）服务器，用于向 Claude Desktop、Cursor 以及任何兼容 MCP 的 AI 助手提供地理数据、实时汇率和 IP 地理位置查询能力。服务器将 ApogeoAPI 的 REST 端点暴露为 AI 助手可调用的工具。
主要能力
- 地理数据查询（国家、州、城市）
- 实时汇率查询
- IP 地理位置定位 以上工具均为只读，并声明了 MCP 工具注解（readOnlyHint、destructiveHint、idempotentHint、openWorldHint），客户端可无需确认提示直接运行。
使用方式
在 claude_desktop_config.json 中添加配置：
- macOS：~/Library/Application Support/Claude/claude_desktop_config.json
- Windows：%APPDATA%\Claude\claude_desktop_config.json 保存文件后重启 Claude Desktop，ApogeoAPI 工具将出现在 Claude 的工具列表中。
在 Cursor 的 MCP 配置文件（~/.cursor/mcp.json）的 mcpServers 下添加相同配置块，然后直接引用构建后的文件。
获取 API 密钥
- 在 app.apogeoapi.com 创建免费账户
- 进入 API Keys 生成新密钥
- 将密钥粘贴到配置中的 APOGEOAPI_KEY 环境变量
套餐要求
Free 计划每月 1,000 次请求，无需信用卡。新账户可获得 14 天完整访问权限。Basic+ 工具的完整访问需升级，升级地址：app.apogeoapi.com/dashboard/billing。
测试
npm test 会构建服务器，通过 stdio 以真实 MCP 客户端启动，并针对实时 API 调用每个工具。测试需要一把可访问所有工具的密钥（Basic+ 或处于 14 天试用期的账户）。
适用场景
适用于需要在 AI 助手对话中直接查询地理信息、汇率或 IP 定位的用户，例如询问“当前阿根廷的美元汇率是多少？”或“定位 IP 8.8.8.8”时，助手会自动调用相应工具。
限制
资料中未提供其他限制说明。
