mcpField
D
domaintrack

domaintrack

本地服务
github.com/CloudCorpRecords安全01 周前更新

关于 domaintrack

domaintrack 是 Domduck 公共域名数据的转发客户端,适用于查询域名声誉和爬虫政策。它提供三种工具,在本地列出工具并将调用转发到无需密钥的公共端点;没有记录的域名会明确标示。

主要功能

  1. 01域名声誉快照
  2. 02robots.txt 中的 AI 爬虫政策
  3. 03llms.txt 发布状态
  4. 04数据来源目录

适用场景

  1. 01查询域名已有的声誉信息
  2. 02检查受跟踪 AI 爬虫的规则
  3. 03确认域名是否发布 llms.txt
  4. 04通过来源目录理解数据字段

MCP 相关

向 MCP 客户端提供三种工具,并通过 Streamable HTTP 会话将调用转发到 Domduck 公共端点。工具列表由本地提供,且不会发送凭据。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"cloudcorprecords-domaintrack": {
"command": "npx",
"args": [
"-y",
"@reneturcios/domaintrack"
]
}
}
}
启动命令npx -y @reneturcios/domaintrack

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@reneturcios/domaintrack0.1.0
ocighcr.io/cloudcorprecords/domaintrack:0.1.0

工具

3

收录的工具列表 · 更新于 1 周前

参数类型必填说明
domainstring是域名。协议、www 和末尾的点会被移除。

详细介绍

domaintrack

domaintrack 用于查询某个域名的公开信息: 其声誉概况、robots.txt 设置的 AI 爬虫策略,以及构成这些答案的数据源列表。

它是一个转发客户端,不是数据存储。答案存放在 Domduck 的公共存储中,并由其无需密钥的公共端点提供;此软件包承载该端点的三工具接口,在本地提供工具列表,并将每次调用转发至上游,原样返回上游响应。无需账户或 API 密钥:公共端点就是全部接口。Domduck 的认证端点及其按日期记录的历史序列是独立的,本客户端不会访问它们——本客户端不会发送任何凭据。

在自动化调用前,有一点值得了解:查询一个从未有人查过的域名并不算错误。返回的概况中,hasReading 会设为 false,这表示存储如实说明尚无该域名的记录。

工具

  • lookup_domain — 某个域名的已存储声誉概况:Domain Rating、Tranco 排名、OpenPageRank、注册日期、TLS 证书状态和 AI 爬虫策略。需要提供 domain。
  • get_ai_crawler_policy — 对八种受跟踪的 AI 爬虫,说明该域名的 robots.txt 是允许、阻止还是未提及它们,并说明是否发布了 llms.txt。需要提供 domain。
  • list_sources — 另外两个工具所用的数据源目录及各数据源的含义。无需参数;如果不熟悉概况字段,请先读取此项。

命令行

npx @reneturcios/domaintrack lookup_domain '{"domain":"example.com"}'
npx @reneturcios/domaintrack get_ai_crawler_policy '{"domain":"example.com"}'
npx @reneturcios/domaintrack list_sources
npx @reneturcios/domaintrack --version

每个工具子命令都会转发一次调用,并将结果内容以 JSON 格式打印。退出码:成功时为 0;上游调用返回错误结果时为 1;用法错误时为 2(未知子命令、JSON 参数格式错误)。

MCP 服务

npx @reneturcios/domaintrack mcp

MCP 客户端配置:

{
  "mcpServers": {
    "domaintrack": {
      "command": "npx",
      "args": ["-y", "@reneturcios/domaintrack", "mcp"]
    }
  }
}

服务端自行响应 tools/list,并通过 Streamable HTTP 会话将每个 tools/call 转发至公共端点(先 initialize,再 notifications/initialized,然后调用),并在进程运行期间复用该会话;如果端点提供 Mcp-Session-Id,也会一并复用。

网络传输中的故障会以本软件包自己的措辞报告,作为以 domaintrack error: 开头的文本结果——上游 JSON-RPC 错误、非 2xx HTTP 状态、无法解析的响应正文或请求失败,都会映射为该前缀后附带相应详情。

Docker

docker run -i ghcr.io/cloudcorprecords/domaintrack            # stdio MCP server
docker run --rm ghcr.io/cloudcorprecords/domaintrack lookup_domain '{"domain":"example.com"}'

配置

  • DOMDUCK_MCP_URL — 覆盖上游端点,默认值为 https://domduck.com/api/mcp/public。(此覆盖设置是我们这边重构添加的;端点本身仍固定为公共端点。)

开发

npm install
npm run build   # tsc -> dist/
npm test        # node test runner via tsx; stubbed upstream, no network
npm run dev     # run the CLI from source

许可证

MIT — 详见 LICENSE。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。