InternetData

InternetData MCP 服务

InternetData API 的官方 Model Context Protocol 服务。

InternetData 发布 IP 和 ASN 数据库，包含地理位置、匿名性、所有权和网络数据，提供 gzip 压缩的 CSV 和 MMDB 格式。此服务为 AI Agent 提供四种只读工具，用于查看我们发布的所有数据库及贵组织对每个数据库的许可状态、查看数据库内容、获取用于验证已有副本的摘要，以及查看近期下载历史。

开始使用

我们将服务托管在 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 下添加 https://mcp.internetdata.io/mcp 作为自定义 MCP 服务，并选择 OAuth。在 Codex 中，安装我们的插件，即可添加带有技能的服务：

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

无论采用哪种方式，您都使用 InternetData 账号登录，ChatGPT 和 Codex 都不会看到您的 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	获取某个数据库文件已发布的摘要。
list_downloads	查看贵组织近期的下载尝试，包括被拒绝的尝试。

所有工具均为只读。

数据库 ID 的两种写法

list_databases 会返回一个 base ID 和一个 versions 数组：

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

base 是许可证使用的名称。versions[].id 是下载使用的名称，也是 database_metadata 和 database_checksum 接受的 ID。工具会在各自的描述中说明这一点，因此 Agent 通常能自行正确处理；不过，如果你在记录中看到某个 ID 被拒绝，了解这一点会很有帮助。

特意不提供下载工具

已发布的数据库有数 GB 大，Agent 不应将其拉取到对话中。database_metadata 可用于了解传输所需的成本，而客户端库或 API 才是实际传输数据的方式。

查看下载历史

list_downloads 返回有限的记录窗口——最多 200 次尝试，按时间从新到旧排列——并且会同时列出被拒绝和成功的尝试，因为拒绝记录及其 http_status 才能回答“它停止工作了”这类问题。结果中没有某个数据库，意味着它不在这个记录窗口内，绝不代表它从未被获取。

其他库

InternetData 为多种语言提供官方客户端库，包括 PHP、Python、Go、Java 和 Ruby。更多信息请访问我们的 GitHub：https://github.com/internetdata

关于 InternetData

提供 IP 地址和 AS 号码的地理定位、匿名性、所有权和网络数据库，授权用户以文件形式下载并自行查询。

许可证

本项目采用 MIT 许可证 许可。