AdminKit

io.github.netbasecorp由 GitHub 账号 netbasecorp 发布v0.1.0更新于 Nov 1, 2026

Network, DNS, mail-auth and MCP endpoint security checks for AI agents, backed by adminkit.net.

已验证STDIO仅桌面云端与基础设施安全与监控

概览

AI 生成的概览

AdminKit 为 AI 助手提供实时的网络、DNS、邮件认证与 MCP 端点安全检查，以及离线 IP 与子网工具。

可以做什么
  • 查询 DNS 记录（A、AAAA、MX、TXT、NS、CAA、PTR、SOA、CNAME），并检查域名的 SPF/DMARC 邮件认证状况
  • 检查域名健康：whois、TLS 证书与 HTTP 安全响应头，以及本机公网 IP、ASN 和 CGNAT 提示
  • 探测 MCP 端点是否存在匿名访问暴露，并对已验证归属的目标检查端口暴露
  • 用通俗语言解释共享的 AdminKit 报告，并读取聚合的蜜罐与遥测趋势
  • 运行离线工具：子网计算、IP 与 IPv6 信息、MAC 厂商查询和 User-Agent 解析
适用场景
适合在助手需要诊断 DNS、邮件认证或域名/TLS 配置，或核查 MCP 端点与自有主机是否暴露时使用。也适合快速做离线的子网与 IP 计算。
运行要求
本地 Python 3.12+ 进程，从软件包安装或用 uvx 运行；需要访问 AdminKit Check API 的网络。可选 ADMINKIT_API_KEY 用于报告解释和更高限额；另有可选的 ADMINKIT_API_BASE、ADMINKIT_SITE_BASE、ADMINKIT_MCP_TIMEOUT_SECONDS 和 ADMINKIT_MCP_RATE_LIMIT_PER_SECOND 设置。
安装前请注意
查询会发往第三方 AdminKit API，因此所检查的域名、IP 和端点信息会发送给它。可选的 ADMINKIT_API_KEY 属于机密，应仅通过环境变量提供。端口与端点检查只应针对自己拥有或获授权测试的系统。

安装

在 SourceWeft 中

  1. 打开 控制台中的 AdminKit，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

AdminKit MCP server + MCP endpoint scan Action

Open-source Model Context Protocol server that gives AI agents (Claude, ChatGPT, Cursor, VS Code, any MCP client) real network, DNS and mail checks from AdminKit, plus a read-only GitHub Action that scans your own MCP endpoint for anonymous-access exposure.

Every tool returns real data from the live AdminKit Check API (https://api.adminkit.net) or pure local computation. When a check cannot be reached, the tool says so; it never invents a result.

Tools

ToolWhat it does
check_ipYour own public IP, ASN and a CGNAT hint (only the caller's own IP).
dns_lookupA / AAAA / MX / TXT / NS / CAA / PTR / SOA / CNAME lookup.
check_mail_authSPF and DMARC posture for a domain.
check_domainAggregate domain health: whois, TLS certificate, HTTP security headers.
check_owned_portsPort exposure check for targets you have verified you own.
check_mcp_endpointExposure probe for an MCP server (initialize + tools/list only).
explain_reportPlain-language AI explanation of a shared AdminKit report (needs an API key).
get_radarAggregated honeypot / telemetry trends from AdminKit Radar.
subnet_calc, ip_info, ipv6_info, mac_vendor, user_agentOffline utilities: subnet math, address info, OUI vendor lookup, User-Agent parsing.

Install

Python 3.12+.

bash
pip install "git+https://github.com/netbasecorp/[email protected]"

or run it without installing, with uv:

bash
uvx --from "git+https://github.com/netbasecorp/[email protected]" adminkit-mcp

Claude Desktop / Claude Code / Cursor (stdio)

json
{  "mcpServers": {    "adminkit": {      "command": "uvx",      "args": ["--from", "git+https://github.com/netbasecorp/[email protected]", "adminkit-mcp"]    }  }}

Streamable HTTP

bash
adminkit-mcp --http 127.0.0.1:8080

Configuration (environment only)

VariableDefaultPurpose
ADMINKIT_API_BASEhttps://api.adminkit.netCheck API base URL.
ADMINKIT_SITE_BASEhttps://adminkit.netSite base URL (fallback for some checks).
ADMINKIT_API_KEYunsetOptional AdminKit API key (explain_report, higher limits). Never logged.
ADMINKIT_MCP_TIMEOUT_SECONDS10Per-request timeout.
ADMINKIT_MCP_RATE_LIMIT_PER_SECOND5Client-side rate limit.

GitHub Action: scan your MCP endpoint

Checks one MCP endpoint for: initialize accepted without credentials, tool list readable anonymously, tool names that look like shell/file/network access, and no TLS. It only sends initialize and tools/list and never calls tools/call, so it is safe against a live server. Outputs a 0-100 exposure score, a job summary, and score / findings-json outputs.

yaml
- 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 }}"
InputDefaultDescription
url(required)MCP endpoint URL to scan.
fail-oncriticalnone, warning (any finding) or critical (high/critical finding).
api-key""Reserved for sending results to the AdminKit dashboard; never sent to the target.
allow-privatefalseAllow a private/loopback target (only for CI fixtures you started yourself).

An unreachable target always fails the step. A private target refused with allow-private: false is reported as skipped. Full workflow: examples/scan-mcp-endpoint.yml.

The same probe runs from the command line:

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

Scan only endpoints you own or are authorised to test.

Development

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

Licence

MIT, see LICENSE. The AdminKit website, API and platform are separate proprietary services operated by Netbase JSC; this repository contains only the open-source client.

来源：README.md，提交 4a9395f

工具

0
SourceWeft 曾在隔离沙箱中以无凭据方式启动该软件包一次，以列出其工具，但未能完成：软件包安装失败。

版本历史

1
  1. v0.1.0最新Nov 1, 2026

评分

已满足适用检查项的 50%

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

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分