メニュー このリポジトリは移動しました。** ScopeBlind/scopeblind-gateway でアクティブな開発が継続されます。 ツイート

この個人的なフォークは、正式リポジトリの後ろにあるかもしれません。 問題、プルリクエスト、および最新のコードについては、orgリポジトリを使用してください。

保護mcp

MCP サーバーのセキュリティゲートウェイ デフォルト、パーツールポリシー、オプションのローカルEd25519レシート、および検証フレンドリーな監査出力によるShadow-modeログ。

Current CLIパス: 任意のstdio MCPサーバーを透明なプロキシとしてラップします。 shadow モードでは、すべての [tools/call]] リクエストをログに記録し、すべてをスルーできます。 ツールルールを強制するためにポリシーファイルを追加します。 [protect-mcp initを実行して、ローカル署名キーと設定を生成し、ゲートウェイは署名されたレシートを出すこともできます。

クイックスタート

それが何をしているか

Protect-mcp は、MCP クライアントとサーバーを stdio プロキシとして扱います。

[tools/call] JSON-RPC リクエストを介入し、:

• Shadow モード (デフォルト): すべてのツール呼び出しをログ化し、すべてのツールを
• モードを強制:block、[rate_limit]、および[min_tierなどのツールポリシー規則を適用します。 -任意ローカル署名:署名が構成されるとき、構造されたログと一緒にEd25519署名されたレシートを排出して下さい

⚠️ This repository has moved. Active development continues at ScopeBlind/scopeblind-gateway.

This personal fork may be behind the canonical repository. Please use the org repo for issues, pull requests, and the latest code.

protect-mcp

Security gateway for MCP servers. Shadow-mode logs by default, per-tool policies, optional local Ed25519 receipts, and verification-friendly audit output.

Current CLI path: wrap any stdio MCP server as a transparent proxy. In shadow mode it logs every tools/call request and allows everything through. Add a policy file to enforce per-tool rules. Run protect-mcp init to generate local signing keys and config so the gateway can also emit signed receipts.

Quick Start

# Wrap an existing OpenClaw / MCP config into a usable pack
npx @scopeblind/passport wrap --runtime openclaw --config ./openclaw.json --policy email-safe

# Shadow mode — log every tool call, enforce nothing
npx protect-mcp -- node my-server.js

# Generate keys + config template for local signing
npx protect-mcp init

# Shadow mode with local signing enabled
npx protect-mcp --policy protect-mcp.json -- node my-server.js

# Enforce mode
npx protect-mcp --policy protect-mcp.json --enforce -- node my-server.js

# Export an offline-verifiable audit bundle
npx protect-mcp bundle --output audit.json

What It Does

protect-mcp sits between your MCP client and server as a stdio proxy:

MCP Client ←stdin/stdout→ protect-mcp ←stdin/stdout→ your MCP server

It intercepts tools/call JSON-RPC requests and:

• Shadow mode (default): logs every tool call and allows everything through
• Enforce mode: applies per-tool policy rules such as block, rate_limit, and min_tier
• Optional local signing: when signing is configured, emits an Ed25519-signed receipt alongside the structured log

All other MCP messages (initialize, tools/list, notifications) pass through transparently.

What Ships Today

• Per-tool policies — block destructive tools, rate-limit expensive ones, and attach minimum-tier requirements
• Structured decision logs — every decision is emitted to stderr with [PROTECT_MCP]
• Optional local signed receipts — generated when you run with a policy containing signing.key_path, persisted to .protect-mcp-receipts.jsonl, and exposed at http://127.0.0.1:9876/receipts
• Offline verification — verify receipts or bundles with npx @veritasacta/verify
• No account required — local keys, local policy, local process

Current Capability Boundaries

These are important before you roll this out or talk to users:

• Signing is not automatic on the bare npx protect-mcp -- ... path. That path logs decisions in shadow mode. For local signing, run npx protect-mcp init and then start the gateway with the generated policy file.