mcp-audit-server

mcp-audit-server

AI エージェントと MCP のセキュリティ監査を行う、軽量な MCP サーバーおよび CLI プロキシです。プライベートな監査 API に接続し、MCP の設定分析、プロンプトインジェクション耐性のテスト、データフローの追跡、パッケージのスキャン、セキュリティポリシーの生成を行います。

このパッケージは軽量なプロキシです。すべてのスキャンロジックは、お客様またはプロバイダーが運用するプライベートなバックエンドにあります。

マネージドホスティングを利用する場合：

• AGENT_SECURITY_API_KEY を設定します
• パッケージは自動的に https://audit.leddconsulting.com を接続先として使用します

セルフホストまたはプライベートネットワークで利用する場合：

• AGENT_SECURITY_BASE_URL に HTTPS API のオリジンを設定します
• または、ループバック／プライベートネットワーク環境でのデプロイでは、AGENT_SECURITY_HOST と AGENT_SECURITY_PORT を設定します

ホスト型バックエンドへのアクセスは、このパッケージには含まれていません。マネージドアクセスまたはライセンス付きのプライベートデプロイをご希望の場合は、Ledd Consulting にお問い合わせください。

レジストリとディレクトリ

• npm パッケージ：ledd-mcp-audit-server
• 公式 MCP Registry 名：io.github.joepangallo/mcp-audit-server
• Glama や PulseMCP などの下流ディレクトリは、公式 MCP Registry から取り込むため、通常はサイトごとに個別に手動登録する必要はありません。
• Glama での作成者認証は任意です。認証すると、Glama のページの所有権を得て、手動同期や再スキャンの操作ができるようになります。

インストール

npm install ledd-mcp-audit-server

パッケージのインストール：ledd-mcp-audit-server インストール後の CLI コマンド：mcp-audit-server

これは npm に公開し、公開 MCP ディレクトリに掲載するパブリックパッケージです。監査エンジン自体はプライベートのままです。

旧パッケージ名 mcp-server-agent-security は廃止されています。アップグレード手順と非推奨化の計画については、MIGRATION.md をご覧ください。

MCP サーバーとしての使用

MCP クライアント（Claude Desktop、Cursor など）の設定に追加します。

{
  "mcpServers": {
    "mcp-audit-server": {
      "command": "npx",
      "args": ["-y", "ledd-mcp-audit-server", "--mcp"],
      "env": {
        "AGENT_SECURITY_API_KEY": "your-issued-api-key"
      }
    }
  }
}

セルフホストのバックエンドを使用する場合は、同じ env ブロックに AGENT_SECURITY_BASE_URL を追加します。

このサーバーは、stdio 経由で 10 個のツールを公開します。

ツール	説明
audit_mcp_config	MCP 設定 JSON を静的解析し、権限、認証、トランスポート、起動時のリスクを確認します
audit_mcp_server	stdio 経由で実行中の MCP サーバーをアクティブにプローブします（AGENT_SECURITY_ADMIN_MODE=1 が必要です）
audit_agent_trust	ツールの権限、実行の来歴、シークレットの露出制御、ポリシーの乖離、デプロイの信頼スコアを監査します
audit_prompt_injection	30 件以上のペイロードを含むインジェクションカタログを使用して、システムプロンプトをテストします
audit_agent_dataflow	エージェントのツールパイプラインを通じた PII とシークレットの露出を追跡します
scan_mcp_package	npm の MCP パッケージをスキャンし、依存関係の脆弱性と危険なパターンを検出します
generate_report	複数の監査結果を統合し、エグゼクティブサマリーを含む総合レポートを生成します
fix_mcp_config	安全でないフラグの削除、トランスポートのアップグレード、シークレットのマスキングにより、設定の問題を自動修正します
harden_system_prompt	インジェクション耐性を高めるガードレールをシステムプロンプトに追加します
generate_policy	MCP 設定から強制適用可能な JSON セキュリティポリシーを生成します

CLI としての使用

CLI はコマンドをプライベートな監査 API に転送します。

# Hosted quick start
export AGENT_SECURITY_API_KEY=your-issued-api-key

# Audit an MCP configuration file
mcp-audit-server scan-config ./claude_desktop_config.json

# Probe a live MCP server (requires AGENT_SECURITY_ADMIN_MODE=1)
mcp-audit-server scan-server npx -y @modelcontextprotocol/server-filesystem /tmp

# Audit trust posture and policy drift for an agent/MCP deployment
mcp-audit-server scan-trust ./claude_desktop_config.json ./claimed-policy.json

# Scan an npm package for vulnerabilities
mcp-audit-server scan-package @modelcontextprotocol/server-shell

# Test a system prompt for injection vulnerabilities
mcp-audit-server scan-injection ./system-prompt.txt

# Trace data flows through an MCP config
mcp-audit-server scan-dataflow ./claude_desktop_config.json

# Auto-fix security issues in an MCP config
mcp-audit-server fix-config ./claude_desktop_config.json

# Harden a system prompt against injection
mcp-audit-server harden-prompt ./system-prompt.txt

# Generate a security policy from an MCP config
mcp-audit-server generate-policy ./claude_desktop_config.json

# Retrieve a previous audit report
mcp-audit-server report <audit-id>

# Output raw JSON instead of formatted tables
mcp-audit-server scan-config ./config.json --json

# Start in MCP stdio server mode
mcp-audit-server --mcp

セルフホストのバックエンドを使用する場合は、AGENT_SECURITY_BASE_URL=https://your-audit-host も設定します。

環境変数

変数	デフォルト	説明
AGENT_SECURITY_BASE_URL	（なし）	監査 API の完全なオリジン。例：https://audit.example.com
AGENT_SECURITY_HOST	127.0.0.1	セルフホスト／プライベートネットワークの監査 API ホスト
AGENT_SECURITY_PORT	3091	セルフホスト／プライベートネットワークの監査 API ポート
AGENT_SECURITY_API_KEY	（なし）	認証アクセス用の API キー。エンドポイントの上書きなしで設定すると、パッケージは https://audit.leddconsulting.com を使用します
AGENT_SECURITY_REQUEST_TIMEOUT_MS	15000	CLI および MCP プロキシ呼び出しのリクエストタイムアウト
AGENT_SECURITY_ADMIN_MODE	（なし）	アクティブなサーバープローブを有効にするには 1 を設定します

検出対象

• ツールのなりすまし -- ツール名の重複、名前空間の衝突（CWE-290）
• ラグプル -- バージョン固定されていないパッケージ、バージョンのずれ（CWE-829）
• プロンプトインジェクション -- 直接的な上書き、指示の乗っ取り、ロールプレイによる制約回避、区切り文字へのインジェクション、エンコーディングによる回避、多言語インジェクション
• 権限昇格 -- 過剰な権限を持つツール、許可リストのないシェル実行、制限のないファイルシステムアクセス
• データの持ち出し -- ツールのパイプラインを介した個人情報の漏洩、外部へのネットワーク経路
• 安全でない通信 -- TLS の欠如、設定ファイル内の平文の認証情報
• 認証の欠如 -- 認証されていない MCP サーバー、API キー要件の欠如
• シェルインジェクション -- ツール設定を介した任意のコマンド実行
• パストラバーサル -- ツール引数での制限のないファイルシステム範囲
• SQL インジェクション -- ツール定義内の生 SQL パターン
• レート制限 -- 公開されているツールへのリクエストスロットリングの欠如
• パッケージの脆弱性 -- npm MCP パッケージの依存関係に含まれる既知の CVE
• 認証情報の露出 -- インラインのシークレット、ローテーションポリシーの欠如
• エージェントの信頼性の乖離 -- 安全だと主張するポリシーと、設定されたツール、ネットワークの状況、または観測されたアクションログとの不一致
• 来歴情報の不足 -- リスクのあるエージェント操作について、アクションや証拠の記録が欠如していること

要件

• Node.js >= 20
• プライベート監査 API へのアクセス。AGENT_SECURITY_API_KEY が設定されている場合、マネージドホスト環境のデフォルトは https://audit.leddconsulting.com です。その他のホスト型 HTTPS デプロイでは AGENT_SECURITY_BASE_URL を、ローカルまたはプライベートネットワークのデプロイでは AGENT_SECURITY_HOST と AGENT_SECURITY_PORT を使用してください。

来歴情報

バージョン 2.0.0 から 2.1.0 はリリースワークフローの導入前に公開されており、来歴証明書は付与されていません。バージョン 3.0.1 以降は、来歴情報に対応した信頼できる公開ワークフローを通じてリリースされています。

.github/workflows/publish.yml のリリースワークフローは、npm の信頼できる公開（OIDC — 長期有効なトークンは不要）を介して、v* タグを npm provenance（npm publish --provenance）付きで公開します。npm audit signatures と npmjs.com の来歴バッジでリリースを検証してください。

ライセンス

MIT

---

Ledd Consulting が開発