@apogeoapi/mcp
MCP（模型上下文协议）服务器 ApogeoAPI --Claude Desktop、Cursor和任何兼容MCP的AI助手的地理数据、实时汇率和IP地理位置。
它做什么
该服务器将ApogeoAPI的REST端点作为AI助手可以直接调用的工具公开。询问Claude“阿根廷当前的美元汇率是多少？”或“Geolocate IP 8.8.8.8”，它将自动调用正确的工具。
可用工具
| 工具 | 说明 | 需要计划 |
|---|---|---|
get_country | 按ISO2/ISO3代码列出的完整国家数据——姓名、首都、地区、人口、货币、实时美元汇率、时区、电话代码 | 免费 |
list_countries | 250多个国家的分页列表 | 免费 |
search_countries | 按部分名称搜索国家 | 免费 |
get_states | 一个国家的所有州/省 | 基本+ |
get_cities | 按数字州ID列出的一个州的所有城市 | 基本+ |
get_currency_rate | 一国货币的实时美元汇率（每4小时更新一次） | 基本+ |
geolocate_ip | 任何IPv4/IPv6的国家、地区、城市、坐标、时区和欧盟成员资格 | 基本+ |
global_search | 在一个查询中跨国家、州和城市搜索 | 免费 |
安装
克劳德桌面
将以下内容添加到您的 claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"apogeoapi": {
"command": "npx",
"args": ["-y", "@apogeoapi/mcp"],
"env": {
"APOGEOAPI_KEY": "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}保存文件后重新启动Claude Desktop。ApogeoAPI工具将出现在Claude的工具列表中。
光标
在下面添加相同的块 mcpServers 在Cursor的MCP配置文件中(~/.cursor/mcp.json).
手动构建
git clone https://github.com/APOGEOAPI/apogeoapi-mcp.git
cd apogeoapi-mcp
npm install
npm run build然后直接引用构建的文件：
{
"mcpServers": {
"apogeoapi": {
"command": "node",
"args": ["/absolute/path/to/mcp-server/dist/index.js"],
"env": {
"APOGEOAPI_KEY": "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}获取API密钥
- 在以下网址创建免费帐户 App.apogeoapi.com
- 首选 API密钥 并生成新密钥
- 将密钥粘贴到
APOGEOAPI_KEY以上环境变量
免费计划不需要信用卡（每月需要1000张）。
计划要求
| 功能 | 免费 | 基础版（每月19美元） | 入门版（每月29美元） | 专业版（每月79美元） | |
|---|---|---|---|---|---|
| 国家（列表、搜索、获取） | 是 | 是 | 有 | 有 | |
| 全局搜索 | 是 | 是 | 有 | 有 | |
| 州和城市 | 否 | 是 | 是 | 有 | 是 |
| 实时汇率 | 否 | 是 | 是 | ||
| IP地理位置 | 否 | 是 | 是 | ||
| 每月请求 | 1000 | 15000 | 10000 | 500000 |
升级至 app.apogeoapi.com/dashboard/billing.
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
APOGEOAPI_KEY | 是 | 仪表板中的API密钥 |
APOGEOAPI_BASE_URL | 否 | 覆盖API基础URL（默认值： https://api.apogeoapi.com) |
许可证
麻省理工学院