Rocky Geo Mcp

rockygeo-mcp

RapidAPI でホストされている RockyGeo IP ジオロケーション API をラップする MCP（Model Context Protocol）サーバーです。MCP 対応クライアント（Claude Desktop、Claude Code など）からツール呼び出しを行い、IPv4／IPv6 のジオロケーションを検索できます。

インストール

npm install
npm run build

設定

変数	デフォルト	備考
RAPIDAPI_KEY	（必須）	x-rapidapi-key として送信されます。--api-key <k> で上書きできます。
ROCKYGEO_BASE_URL	https://rocky-geo.p.rapidapi.com/v1	別の Rocky Geo API プロバイダーを指定します。
ROCKYGEO_RAPIDAPI_HOST	ベース URL から解析	*.rapidapi.com ホストの場合、x-rapidapi-host として送信されます。

MCP クライアントの設定

クライアント設定（Claude Code の ~/.claude.json、Claude Desktop の claude_desktop_config.json など）に追加します。

{
  "mcpServers": {
    "rockygeo": {
      "command": "node",
      "args": ["/Users/cyborg97/rockygeomcp/dist/index.js"],
      "env": { "RAPIDAPI_KEY": "<your-key>" }
    }
  }
}

ツール

• lookup_ip — { ip: string } → 1 つの IP のジオロケーション。プライベート IP／予約済み IP の場合は { found: false } を返します。
• lookup_ips_batch — { ips: string[] }（1～100 件）→ { results: { [ip]: ... } }。
• health_check — {} → { status, dataVersion, lastSyncAt, uptime }。

Inspector でのスモークテスト

RAPIDAPI_KEY=<key> npx @modelcontextprotocol/inspector node dist/index.js

次に Inspector の UI で、ツールを一覧表示し、lookup_ip を { "ip": "8.8.8.8" } で実行します。

統合テスト

tests/integration.test.js のエンドツーエンドテストでは、ビルド済みサーバーを子プロセスとして起動し、実際の MCP stdio トランスポート経由ですべてのツールを実行して、稼働中の RockyGeo API にアクセスします。

npm test

環境変数に RAPIDAPI_KEY が設定されていない場合、ランナーが入力を求めます（入力内容は表示されません）。また、dist/ がない場合はランナーが自動的にビルドします。

注：テストは実際の上流 API にアクセスするため、RapidAPI のクォータを消費し、Free プランではレート制限（1 RPS）に達する場合があります。

ライセンス

MIT。