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 覆寫 API 位址。需要能連線至 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 分