Apogeoapi Mcp

com.apogeoapi由 apogeoapi.com 发布v1.0.2更新于 Oct 24, 2026

Geographic data API: 250+ countries, 150K+ cities, IP geolocation, 161 live FX rates.

已验证STDIO仅桌面位置与生活金融

概览

AI 生成的概览

本地 MCP 服务器，封装 ApogeoAPI 地理数据：国家、州省与城市查询、IP 定位和实时美元汇率。

可以做什么
  • 按 ISO 代码或部分名称查询和列出国家，含首都、地区、人口、货币与时区
  • 获取某国的州省列表，以及某州下的城市列表
  • 用一次查询同时搜索国家、州省和城市
  • 查询某国货币的实时美元汇率，每四小时更新
  • 将 IPv4 或 IPv6 地址定位到国家、地区、城市、坐标和时区
适用场景
适合助手在回答中需要地理或货币参考数据的场景，例如解析国家代码、列出某地区的城市或查询 IP 地址归属地。若你已使用或计划订阅 ApogeoAPI，则值得添加。
运行要求
通过 npx 从 npm 包 @apogeoapi/mcp 在本地运行，或使用 Node.js 手动构建。需要 ApogeoAPI 账户，并在 APOGEOAPI_KEY 环境变量中提供 API 密钥；可选 APOGEOAPI_BASE_URL 覆盖接口地址。需要能访问 ApogeoAPI 服务的网络。
安装前请注意
APOGEOAPI_KEY 中的密钥是可计费凭据，应避免放入共享配置。城市、全局搜索、汇率和 IP 定位等工具在 14 天试用期后需要 Basic 及以上付费套餐，套餐为每月 19 至 79 美元并含请求配额。查询内容（包括 IP 地址）会发送到 ApogeoAPI 服务器。所有工具均为只读。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Apogeoapi Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@apogeoapi/mcp

MCP (Model Context Protocol) server for ApogeoAPI — geographic data, live exchange rates, and IP geolocation for Claude Desktop, Cursor, and any MCP-compatible AI assistant.

What it does

This server exposes ApogeoAPI's REST endpoints as tools that AI assistants can call directly. Ask Claude "What is the current USD rate for Argentina?" or "Geolocate IP 8.8.8.8" and it will call the right tool automatically.

Available tools

ToolDescriptionPlan required
get_countryFull country data by ISO2/ISO3 code — name, capital, region, population, currency, timezones, phone code (plus the live USD rate on Basic+)Free
list_countriesPaginated list of all 250+ countriesFree
search_countriesSearch countries by partial nameFree
get_statesAll states/provinces for a countryFree
get_citiesAll cities for a state by numeric state IDBasic+
get_currency_rateLive USD exchange rate for a country's currency (updated every 4 hours)Basic+
geolocate_ipCountry, region, city, coordinates, timezone, and EU membership for any IPv4/IPv6Basic+
global_searchSearch across countries, states, and cities in one queryBasic+

Every new account gets 14 days of full access to the Basic+ tools, no credit card required.

All tools are read-only and declare the MCP tool annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), so clients can run them without a confirmation prompt.

Installation

Claude Desktop

Add the following to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
json
{
  "mcpServers": {
    "apogeoapi": {
      "command": "npx",
      "args": ["-y", "@apogeoapi/mcp"],
      "env": {
        "APOGEOAPI_KEY": "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Restart Claude Desktop after saving the file. The ApogeoAPI tools will appear in Claude's tool list.

Cursor

Add the same block under mcpServers in Cursor's MCP configuration file (~/.cursor/mcp.json).

Manual build

bash
git clone https://github.com/APOGEOAPI/apogeoapi-mcp.git
cd apogeoapi-mcp
npm install
npm run build

Then reference the built file directly:

json
{
  "mcpServers": {
    "apogeoapi": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
      "env": {
        "APOGEOAPI_KEY": "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Getting an API key

  1. Create a free account at app.apogeoapi.com
  2. Go to API Keys and generate a new key
  3. Paste the key into the APOGEOAPI_KEY environment variable above

No credit card required for the Free plan (1,000 req/month). New accounts get 14 days of full access.

Plan requirements

FeatureFreeBasic ($19/mo)Starter ($29/mo)Professional ($79/mo)
Countries (list, search, get)YesYesYesYes
States & provincesYesYesYesYes
Cities14-day trialYesYesYes
Global search14-day trialYesYesYes
Live currency rates14-day trialYesYesYes
IP geolocation14-day trialYesYesYes
Monthly requests1,00015,000100,000500,000

Upgrade at app.apogeoapi.com/dashboard/billing.

Environment variables

VariableRequiredDescription
APOGEOAPI_KEYYesYour API key from the dashboard
APOGEOAPI_BASE_URLNoOverride the API base URL (default: https://api.apogeoapi.com)

Tests

npm test builds the server, starts it over stdio with a real MCP client and calls every tool against the live API. It needs a key with access to every tool (Basic+ or an account in its 14-day trial):

bash
APOGEOAPI_KEY=your_key npm test

License

MIT

来源：README.md，提交 b897f20

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分