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 分