AdminKit

AdminKit MCP サーバー＋MCP エンドポイントスキャン Action

AI エージェント（Claude、ChatGPT、Cursor、VS Code、あらゆる MCP クライアント）に、AdminKit の実ネットワーク、DNS、メールチェックを提供するオープンソースの Model Context Protocol サーバーです。また、匿名アクセスによる露出がないか、独自の MCP エンドポイントをスキャンする読み取り専用の GitHub Action も提供します。

• ウェブサイト： 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 レポートを平易な言葉で AI が解説します（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 エンドポイントをスキャンする

1 つの MCP エンドポイントについて、認証情報なしで initialize が受け付けられるか、匿名でツール一覧を読み取れるか、シェル／ファイル／ネットワークアクセスを示すツール名があるか、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

ライセンス

MIT。LICENSE を参照してください。AdminKit のウェブサイト、API、プラットフォームは Netbase JSC が運営する独立したプロプライエタリサービスです。このリポジトリに含まれるのはオープンソースのクライアントのみです。