FindIP

FindIP MCP サーバー

IP アドレスやリスクのあるセッションについてアシスタントに質問すると、FindIP から回答を得られます。

@findip/mcp は、FindIP 用の Model Context Protocol サーバーです。Claude、Cursor などの MCP クライアントに、IP インテリジェンスと FindIP Shield のリスクシグナルを提供します。stdio 経由でローカルに実行され、データの読み取りのみを行います。

ツール

ツール	機能	キー
lookup_ip	IP の国、都市、ISP、ASN、およびリスクシグナル（VPN、プロキシ、Tor、リレー、ホスティング、スキャナー、悪意のあるリストへの掲載、脅威スコア）	API キー
verify_session	Shield セッションのサーバー側リスクチェック：スコア、推奨事項、チャレンジの状態、IP とネットワークのローテーション	サイトシークレットキー
list_shield_sites	今日のイベント数とリスクのあるイベント数を含む、Shield サイトの一覧	API キー
recent_risky_events	サイトで最近発生した高リスクイベント。たとえば「今週、登録フォームにどのようなリスクのあるトラフィックがあったか」	API キー
explain_event	1 件のイベントを平易な言葉で説明：発生元、検出されたシグナル、推奨された対応	API キー

5 つのツールはすべて読み取り専用です。各ツールが使用する FindIP エンドポイントは docs/BACKEND.md に記載されています。

セットアップ

Node.js 18.17 以降と FindIP API キーが必要です。キーは findip.net で無料で取得できます。

Claude Code

claude mcp add findip --env FINDIP_API_KEY=your_api_key -- npx -y @findip/mcp

Claude Desktop

これを claude_desktop_config.json に追加し（Settings、Developer、Edit Config）、Claude Desktop を再起動します。

{
  "mcpServers": {
    "findip": {
      "command": "npx",
      "args": ["-y", "@findip/mcp"],
      "env": {
        "FINDIP_API_KEY": "your_api_key"
      }
    }
  }
}

Cursor

これを ~/.cursor/mcp.json、またはプロジェクト内の .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "findip": {
      "command": "npx",
      "args": ["-y", "@findip/mcp"],
      "env": {
        "FINDIP_API_KEY": "your_api_key"
      }
    }
  }
}

設定

変数	用途
FINDIP_API_KEY	FindIP API キーです。lookup_ip、list_shield_sites、recent_risky_events、explain_event に必要です。
FINDIP_SHIELD_SECRET_KEY	Shield サイトのシークレットキー（sec_...）です。verify_session に必要です。Shield ダッシュボードのサイト設定で確認できます。
FINDIP_SHIELD_ACCOUNT_API	0 に設定すると、Shield アカウント用の 3 つのツールが無効になり、API キーは IP の検索にのみ使用されます。デフォルトでは有効です。
FINDIP_TIMEOUT_MS	リクエストのタイムアウトです。デフォルトは 15000 です。
FINDIP_API_BASE_URL、FINDIP_SHIELD_BASE_URL、FINDIP_PORTAL_BASE_URL	テスト用に FindIP のホストを上書きします。

Shield アカウント用ツールのリクエスト上限は、アカウントあたり 1 分間に 60 回です。誤ったキーでリクエストを繰り返すと、10 分間ブロックされます。

キーは環境からのみ読み取られます。ツールの引数として受け付けられることはなく、ツールの出力やエラーメッセージに表示されることもありません。

使用例

• 「203.0.113.9 を調べてください。VPN ですか、それともホスティングプロバイダーですか？」
• 「Shield セッション sess_8f2c を検証して、フラグが付いた理由を教えてください。」
• 「今週、登録フォームにどのようなリスクのあるトラフィックがありましたか？」
• 「shop.example のイベント 5b1e... を説明してください。心配する必要はありますか？」

結果の読み方

FindIP はリスクシグナルを報告します。VPN、ホスティングネットワーク、高いスコアが示すのは接続についてであり、その背後にいる人物についてではありません。シグナルを使って、より詳しく確認する対象や追加の手順、手動レビューが必要な対象を判断してください。

Shield ブラウザー SDK はシグナルを収集し、ページに追加の手順を導入できますが、ブラウザーはスクリプト化や回避が可能なため、セキュリティ境界にはなりません。重要な判断はサーバー上で行ってください。許可、チャレンジ、ブロックを行う前に、バックエンドからサーバー検証（verify_session が使用するエンドポイント）を呼び出してください。risk_status: "unknown" のセッションには IP インテリジェンスがありません。「安全」ではなく「不明」として扱ってください。

プライバシー

• サーバーが通信するのは FindIP のみです：api.findip.net、shield.findip.net、www.findip.net。
• Shield ツールはエンドユーザーの識別情報（メールアドレス、ユーザー ID、およびそれらのハッシュ）を返しません。FindIP はデータがサーバーから送信される前に、これらの情報を削除します。
• サイト一覧は簡潔な概要です。サイトキーや設定は含まれません。
• テレメトリーはなく、ディスクへの書き込みもありません。

開発

npm install
npm run typecheck
npm test        # vitest, all HTTP mocked
npm run build

ライセンス

MIT