AdminKit

本地服务

adminkit.net安全01 周前更新

代码仓库访问官网

关于 AdminKit

AdminKit 是开源 MCP 服务，可使用实时 AdminKit 数据或本地计算执行网络、DNS、邮件认证和域名检查。它面向 AI 客户端用户，也适合希望用只读 GitHub Action 检查自有 MCP 端点暴露情况的团队。

主要功能

01IP、DNS 和邮件认证检查
02域名健康与自有端口检查
03MCP 端点暴露探测
04离线子网和地址工具
05提供暴露评分的只读 GitHub Action

适用场景

01检查 DNS 记录以及 SPF 或 DMARC 状态
02检查域名的 TLS 和 HTTP 安全标头
03在 CI 中扫描自有 MCP 端点是否允许匿名访问

MCP 相关

MCP 服务提供网络、DNS、邮件认证、域名、端口和 MCP 端点检查，以及离线工具。工具返回 AdminKit Check API 的实时结果或本地计算结果。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "netbasecorp-adminkit": {
      "command": "uvx",
      "args": [
        "adminkit-mcp"
      ],
      "env": {
        "ADMINKIT_API_KEY": "<ADMINKIT_API_KEY>"
      }
    }
  }
}

启动命令uvx adminkit-mcp

需要配置的环境变量

ADMINKIT_API_KEY密钥Optional AdminKit API key (explain_report, higher limits)

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

安装包

pypiadminkit-mcp0.1.0stdio

工具

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

参数	类型	必填	说明
ip	any	否

详细介绍

AdminKit MCP 服务 + MCP 端点扫描 Action

开源的 Model Context Protocol 服务，可让 AI Agent （Claude、ChatGPT、Cursor、VS Code 及任何 MCP 客户端）通过 AdminKit 执行真实的网络、DNS 和邮件检查；还提供一个只读 GitHub Action，用于扫描你自己的 MCP 端点，检查是否存在匿名访问暴露。

网站： https://adminkit.net · MCP 文档： https://adminkit.net/developers/mcp/
许可证： MIT · 维护者： Netbase JSC

每个工具都会从实时 AdminKit Check API（https://api.adminkit.net）获取真实数据，或执行纯本地计算。如果无法访问检查服务，工具会如实说明；绝不捏造结果。

工具

工具	功能
`check_ip`	查询你自己的公网 IP、ASN 和 CGNAT 提示（仅限调用者自己的 IP）。
`dns_lookup`	查询 A / AAAA / MX / TXT / NS / CAA / PTR / SOA / CNAME 记录。
`check_mail_auth`	检查域名的 SPF 和 DMARC 状况。
`check_domain`	汇总域名健康状况：whois、TLS 证书、HTTP 安全标头。
`check_owned_ports`	检查已验证归你所有的目标所暴露的端口。
`check_mcp_endpoint`	探测 MCP 服务的暴露情况（仅执行 `initialize` + `tools/list`）。
`explain_report`	用通俗语言解释共享的 AdminKit 报告（需要 API 密钥）。
`get_radar`	获取 AdminKit Radar 汇总的蜜罐 / 遥测趋势。
`subnet_calc`, `ip_info`, `ipv6_info`, `mac_vendor`, `user_agent`	离线工具：子网计算、地址信息、OUI 厂商查询、User-Agent 解析。

安装

Python 3.12+。

pip install adminkit-mcp

也可以通过 uv 直接运行，无需安装：

uvx adminkit-mcp

Claude Desktop / Claude Code / Cursor（stdio）

{
  "mcpServers": {
    "adminkit": {
      "command": "uvx",
      "args": ["adminkit-mcp"]
    }
  }
}

Streamable HTTP

adminkit-mcp --http 127.0.0.1:8080

配置（仅通过环境变量）

变量	默认值	用途
`ADMINKIT_API_BASE`	`https://api.adminkit.net`	Check API 基础 URL。
`ADMINKIT_SITE_BASE`	`https://adminkit.net`	网站基础 URL（部分检查的备用地址）。
`ADMINKIT_API_KEY`	未设置	可选的 AdminKit API 密钥（用于 `explain_report`，并提高限额）。绝不记录到日志。
`ADMINKIT_MCP_TIMEOUT_SECONDS`	`10`	单次请求超时时间。
`ADMINKIT_MCP_RATE_LIMIT_PER_SECOND`	`5`	客户端限速。

GitHub Action：扫描你的 MCP 端点

检查一个 MCP 端点是否存在以下情况：无需凭据即可接受 initialize、可匿名读取工具列表、存在名称看似具有 shell / 文件 / 网络访问能力的工具，以及缺少 TLS。它只发送 initialize 和 tools/list，绝不调用 tools/call，因此可安全用于运行中的服务。输出 0–100 的暴露评分、作业摘要，以及 score / findings-json 输出。

- name: Scan our MCP endpoint
  id: scan
  uses: netbasecorp/[email protected]
  with:
    url: https://mcp.example.com/mcp
    fail-on: critical # none | warning | critical
- run: echo "score ${{ steps.scan.outputs.score }}"

输入	默认值	说明
`url`	（必填）	要扫描的 MCP 端点 URL。
`fail-on`	`critical`	`none`、`warning`（存在任意发现项）或 `critical`（存在高危 / 严重发现项）。
`api-key`	`""`	预留用于向 AdminKit 仪表板发送结果；绝不会发送给目标。
`allow-private`	`false`	允许私有 / 回环目标（仅用于你自行启动的 CI 测试设施）。

无法访问目标时，步骤始终会失败。若 allow-private: false 且拒绝访问私有目标，则会报告为 skipped。完整工作流： examples/scan-mcp-endpoint.yml。

同一探测也可通过命令行运行：

adminkit-mcp probe https://mcp.example.com/mcp

仅扫描归你所有或你获准测试的端点。

开发

pip install -e ".[dev]"
pytest            # every test runs against local fakes on 127.0.0.1, no network
ruff check . && mypy
bash action/test/test_action.sh