InternetData

InternetData MCP サーバー

InternetData API 用の公式 Model Context Protocol サーバーです。

InternetData は、地理位置情報、匿名性、所有権、ネットワークデータなどの IP および ASN データベースを、gzip 圧縮 CSV と MMDB 形式で公開しています。このサーバーでは、それらのデータベースに対して、AI エージェントが読み取り専用の 4 つのツールを利用できます。公開しているすべてのデータベースと、各データベースに対する組織のライセンス状況、データベースの内容、すでにお持ちのコピーを検証するためのダイジェスト、最近のダウンロード履歴を確認できます。

はじめに

https://mcp.internetdata.io/mcp でホストしており、InternetData アカウントでサインインして利用できます。また、npm からご自身のマシンで実行することもできます。どちらの場合も、各データベースに対する組織のライセンス状況を確認できます。データベースは契約に基づいてライセンスされています。tor_ip_v1 などの Open データベースは、最初からすべての組織にライセンスされており、CC BY-SA 4.0 のもとで無料で利用できます。それ以外については、API ドキュメントをご覧ください。組織がまだライセンスをお持ちでない場合は、評価ライセンスをリクエストしてください。

Claude で利用する

claude.ai、デスクトップアプリ、または Cowork で、カスタムコネクターとして https://mcp.internetdata.io/mcp を追加し、求められたら Use Claude's published identity を選択します。Claude Code では、スキルとともにサーバーを追加するプラグインをインストールします。

/plugin marketplace add internetdata/claude-plugin
/plugin install internetdata@internetdata

どちらの場合も InternetData アカウントでサインインするため、Claude に API キーが見えることはありません。手順、スキル、切断方法については、docs.internetdata.io/integrations/claudeをご覧ください。

ChatGPT と Codex で利用する

ウェブ版 ChatGPT では、Plugins の下にカスタム MCP サーバーとして https://mcp.internetdata.io/mcp を追加し、OAuth を選択します。Codex では、スキルとともにサーバーを追加するプラグインをインストールします。

codex plugin marketplace add internetdata/openai-plugin
codex plugin add internetdata@internetdata
codex mcp login internetdata

どちらの場合も InternetData アカウントでサインインするため、API キーが見られることはありません。手順については、docs.internetdata.io/integrations/chatgptおよびdocs.internetdata.io/integrations/codexをご覧ください。OpenAI API では、Responses API の mcp ツールに、サーバーを server_url として、キーを authorization として指定します。

その他の MCP クライアントで利用する

https://mcp.internetdata.io/mcp を指定してください。MCP 認証に対応しているクライアントでは、同じ方法でサインインします。対応していないクライアントでは、Authorization: Bearer your-key としてキーを送信できます。

ご自身のマシンで実行する

db.download スコープを持つ API キーが必要です。MCP クライアントの設定に次を追加してください。

{
  "mcpServers": {
    "internetdata": {
      "command": "npx",
      "args": ["-y", "internetdata-mcp"],
      "env": { "INTERNETDATA_API_KEY": "your-key" }
    }
  }
}

Node.js 22 以降が必要です。別のエンドポイントを指定する場合は、INTERNETDATA_BASE_URL で上書きできます。

ツール

ツール	回答する内容
list_databases	公開しているすべてのデータベースと、組織の standing（licensed、expired、unlicensed のいずれか）、およびライセンスがある場合はその種類と期間。
database_metadata	データベースの列、サンプル行、行数、ビルド日、ファイルサイズ。
database_checksum	1 つのデータベースファイルについて公開されているダイジェスト。
list_downloads	拒否されたものも含む、組織の最近のダウンロード試行。

すべてのツールは読み取り専用です。

データベース ID の 2 つの表記

list_databases は base ID と versions 配列を返します。

{
  "base": "vpn_ip",
  "standing": "licensed",
  "open": false,
  "versions": [{ "id": "vpn_ip_v1", "version": 1, "formats": ["csvgz", "mmdb"] }]
}

base はライセンスで使われる ID です。versions[].id はダウンロードで使われる ID で、database_metadata と database_checksum が受け付けるのはこちらです。各ツールの説明にも記載されているため、エージェントは通常、自分で正しい ID を選べます。どちらかが拒否されたトランスクリプトを読む際に知っておくと便利です。

ダウンロードツールがないのは意図的です

公開されているビルドは数 GB にもなるため、エージェントが会話に取り込むようなものではありません。転送にかかる容量を調べるには database_metadata を使い、実際にデータを転送するにはクライアントライブラリまたは API を使います。

ダウンロード履歴の読み方

list_downloads は最大 200 件の試行を新しい順に表示する、上限付きの一覧です。拒否された試行も成功した試行とあわせて表示します。拒否の有無とその http_status によって、「動作しなくなった」という問題の答えがわかるためです。結果にデータベースがない場合、それは表示対象の範囲に含まれていないことを意味し、過去に一度も取得されていないことを意味するわけではありません。

その他のライブラリ

PHP、Python、Go、Java、Ruby など、多くの言語に対応した InternetData の公式クライアントライブラリを利用できます。詳しくは https://github.com/internetdata をご覧ください。

InternetData について

IP アドレスと AS 番号を対象とした、位置情報、匿名性、所有者情報、ネットワークのデータベースです。ファイルとしてライセンスを取得してダウンロードし、ご自身でクエリして利用します。

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。