InternetData

io.internetdata由 internetdata.io 发布官方发布者v3.1.11更新于 Nov 7, 2026

List InternetData's IP and ASN databases, your license for each, what one holds, and its digests.

已验证Streamable HTTP可网页运行数据库数据与分析

概览

AI 生成的概览

以只读方式访问 InternetData 的 IP 与 ASN 数据库目录:授权状态、内容、校验摘要与下载记录。

可以做什么
  • 列出所有已发布的 IP 与 ASN 数据库,以及贵组织的授权状态、授权类型与期限
  • 查看某个数据库的字段、示例行、行数、构建日期与文件大小
  • 获取某个数据库文件的已发布摘要,用于校验本地已有的副本
  • 查看贵组织近期的下载尝试记录,包括被拒绝的请求
适用场景
当你使用 InternetData 的地理位置、匿名性、归属或网络数据,并希望助手确认贵组织已获授权哪些数据库、某个数据库包含什么内容,或本地副本是否与已发布摘要一致时适用。
运行要求
可使用远程端点并通过 InternetData 账户登录;或使用 npx 运行本地 npm 包,需要 Node.js 22 或更高版本,以及具备 db.download 权限的 API 密钥(INTERNETDATA_API_KEY)。可用 INTERNETDATA_BASE_URL 覆盖端点。
安装前请注意
本地包需要 API 密钥,通过 INTERNETDATA_API_KEY 传入;托管端点则使用账户登录。数据库按合同授权,多数并非免费,使用前请确认授权状态。所有工具均为只读,且刻意不提供下载工具。

安装

在 SourceWeft 中

  1. 打开 控制台中的 InternetData,将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.internetdata%2Fmcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "internetdata": {
      "type": "http",
      "url": "https://mcp.internetdata.io/mcp"
    }
  }
}

README

[InternetData] InternetData MCP Server

[npm] [license]

The official Model Context Protocol server for the InternetData API.

InternetData publishes IP and ASN databases: geolocation, anonymity, ownership and network data, as gzipped CSV and as MMDB. This server gives an AI agent four read-only tools over them - every database we publish and where your organization's license for each one stands, what is inside one, the digests to verify a copy you already hold, and your recent download history.

Getting Started

We host it at https://mcp.internetdata.io/mcp, and you sign in to it with your InternetData account. It also runs on your own machine from npm. Either way it sees where your organization's license for each database stands. Databases are licensed by contract. The Open ones, tor_ip_v1 among them, are licensed to every organization from the start and are free under CC BY-SA 4.0. For the rest, see the API documentation, or request an evaluation if your organization doesn't have a license yet.

In Claude

In claude.ai, the desktop app or Cowork, add https://mcp.internetdata.io/mcp as a custom connector and choose Use Claude's published identity when asked. In Claude Code, install our plugin, which adds the server with skills:

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

Either way you sign in with your InternetData account, and Claude never sees your API key. The steps, the skills and how to disconnect: docs.internetdata.io/integrations/claude.

In ChatGPT and Codex

InternetData is in the plugin directory ChatGPT and Codex share: add it from its listing. Codex also installs our plugin from the command line, which adds the server with skills:

console
codex plugin marketplace add internetdata/openai-plugincodex plugin add internetdata@internetdatacodex mcp login internetdata

Either way you sign in with your InternetData account, and neither sees your API key. The steps: docs.internetdata.io/integrations/chatgpt and docs.internetdata.io/integrations/codex. On the OpenAI API, the Responses API's mcp tool takes the server as its server_url and your key as its authorization.

In any other MCP client

Point it at https://mcp.internetdata.io/mcp. A client that supports MCP authorization signs in the same way. One that doesn't can send a key instead, as Authorization: Bearer your-key.

On your own machine

You need an API key carrying the db.download scope. Add this to your MCP client's config:

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

Requires Node.js 22 or newer. INTERNETDATA_BASE_URL overrides the endpoint if you need to point somewhere else.

Tools

ToolWhat it answers
list_databasesEvery database we publish, with its standing for your organization (licensed, expired or unlicensed) and the type and term of any license.
database_metadataA database's columns, sample rows, row count, build date and file sizes.
database_checksumThe published digests for one database file.
list_downloadsYour organization's recent download attempts, refusals included.

Every tool is read-only.

Two spellings of a database ID

list_databases answers a base ID and a versions array:

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

The base is what a license names. versions[].id is what a download names, and it is the one database_metadata and database_checksum accept. The tools say so in their own descriptions, so an agent generally gets this right on its own; it is worth knowing when you read a transcript where one was refused.

There is no download tool, deliberately

The published builds run to several GB, which is not something an agent should pull into a conversation. database_metadata is how you find out what a transfer would cost, and the client libraries or the API are how you actually move the bytes.

Reading the download history

list_downloads is a bounded window - at most 200 attempts, newest first - and it lists refusals alongside successes, because a denial and its http_status are what answer "it stopped working". A database missing from the answer means it is not in that window, never that it was never fetched.

Other Libraries

There are official InternetData client libraries available for many languages including PHP, Python, Go, Java, and Ruby. See our GitHub at https://github.com/internetdata for more.

About InternetData

Geolocation, anonymity, ownership and network databases for IP addresses and AS numbers, licensed as files you download and query yourself.

[InternetData]

License

This project is licensed under the MIT License.

来源:README.md,提交 8c1c17b

工具

4

list_databases

List databases

The IP database catalog as this API key's organization may see it, one entry per database FAMILY, with `standing` saying where their license stands: `licensed` if the family is theirs today, `expired` if the term has ended, `unlicensed` if it is published but has never been bought. Each entry has a `base` ID, which is what a license names, and a `versions` array whose `id` is what the other tools take - pass `versions[].id` (`bogon_ip_v1`), never the `base` (`bogon_ip`). Ask again rather than holding on to this: it is answered per key and is not the same for everyone.

无需输入参数。

database_metadata

Describe a database

What is inside one database before you fetch it: the columns in each published format with their types, a few sample rows, the row count, the build date and the file sizes. Use this to answer questions about what a database contains without downloading it - the files reach several GB - and to budget a transfer before starting one.

输入参数dataset_id必填

database_checksum

Get a database's checksums

The published digests for one database file, for verifying a copy you already hold or deciding whether a build has changed since you last fetched it. It is licensed like the download itself, so a database this key cannot download is refused here too. Looking up a checksum is not a download and does not appear in `list_downloads`.

输入参数format必填dataset_id必填

list_downloads

List recent download attempts

This organization's own recent download attempts, newest first, REFUSALS INCLUDED - a denial carries the `outcome` and `http_status` that answer "it stopped working", which nothing else here can. Use it to explain a failing fetch, to confirm a transfer ran, or to check whether a request was theirs. This is a bounded WINDOW of at most 200 rows, so a database missing from the answer means it is not in this window - never that it was never downloaded.

输入参数limit

版本历史

4
  1. v3.1.11最新Nov 7, 2026
  2. v3.1.10Nov 3, 2026
  3. v3.1.7Oct 21, 2026
  4. v3.1.6Oct 19, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Internetdata 集成