ApogeoAPI

@apogeoapi/mcp

ApogeoAPI 用の MCP（Model Context Protocol）サーバーです。Claude Desktop、Cursor、および MCP 対応のあらゆる AI アシスタントで、地理データ、最新の為替レート、IP ジオロケーションを利用できます。

このサーバーでできること

このサーバーは、ApogeoAPI の REST エンドポイントを、AI アシスタントから直接呼び出せるツールとして公開します。Claude に「アルゼンチンの現在の USD レートは？」や「IP 8.8.8.8 の位置を特定して」と尋ねると、適切なツールが自動的に呼び出されます。

利用可能なツール

ツール	説明	必要なプラン
get_country	ISO2／ISO3 コードで国の詳細データを取得します。名称、首都、地域、人口、通貨、タイムゾーン、電話番号コードを含みます（Basic+ では最新の USD レートも含みます）	Free
list_countries	250 以上のすべての国のページ分割された一覧	Free
search_countries	部分一致する名称で国を検索します	Free
get_states	国のすべての州／県を取得します	Free
get_cities	数値の州 ID で州内のすべての都市を取得します	Basic+
get_currency_rate	国の通貨の最新 USD 為替レートを取得します（4 時間ごとに更新）	Basic+
geolocate_ip	あらゆる IPv4／IPv6 アドレスの国、地域、都市、座標、タイムゾーン、EU 加盟状況を取得します	Basic+
global_search	1 回のクエリで国、州、都市を横断検索します	Basic+

新しいアカウントはすべて、クレジットカード不要で Basic+ ツールを 14 日間フルアクセス できます。

すべてのツールは読み取り専用で、MCP ツールのアノテーション（readOnlyHint、destructiveHint、idempotentHint、openWorldHint）を宣言しているため、クライアントは確認プロンプトなしで実行できます。

インストール

Claude Desktop

claude_desktop_config.json に以下を追加します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "apogeoapi": {
      "command": "npx",
      "args": ["-y", "@apogeoapi/mcp"],
      "env": {
        "APOGEOAPI_KEY": "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

ファイルを保存した後、Claude Desktop を再起動します。ApogeoAPI のツールが Claude のツール一覧に表示されます。

Cursor

Cursor の MCP 設定ファイル（~/.cursor/mcp.json）の mcpServers の下に同じブロックを追加します。

手動ビルド

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 キーの取得

1. app.apogeoapi.com で無料アカウントを作成します
2. API Keys に移動し、新しいキーを生成します
3. キーを上記の APOGEOAPI_KEY 環境変数に貼り付けます

Free プラン（毎月 1,000 リクエスト）はクレジットカード不要です。新しいアカウントは 14 日間フルアクセスできます。

プラン要件

機能	Free	Basic ($19/mo)	Starter ($29/mo)	Professional ($79/mo)
国（一覧、検索、取得）	はい	はい	はい	はい
州・県	はい	はい	はい	はい
都市	14 日間のトライアル	はい	はい	はい
グローバル検索	14 日間のトライアル	はい	はい	はい
最新の為替レート	14 日間のトライアル	はい	はい	はい
IP ジオロケーション	14 日間のトライアル	はい	はい	はい
毎月のリクエスト数	1,000	15,000	100,000	500,000

app.apogeoapi.com/dashboard/billing でアップグレードできます。

環境変数

変数	必須	説明
APOGEOAPI_KEY	はい	ダッシュボードで取得した API キー
APOGEOAPI_BASE_URL	いいえ	API のベース URL を上書きします（デフォルト：https://api.apogeoapi.com）

テスト

npm test はサーバーをビルドし、実際の MCP クライアントを使って stdio 経由で起動し、ライブ API に対してすべてのツールを呼び出します。すべてのツールにアクセスできるキー（Basic+ または 14 日間のトライアル期間中のアカウント）が必要です。

APOGEOAPI_KEY=your_key npm test

ライセンス

MIT