Shield MCP 0pe

🚀 Shield MCP 防护中间件

Model Context Protocol (MCP) サーバーのセキュリティと監視機能を強化するためのミドルウェアで、公式 SDK を変更する必要はありません。このパッケージは、MCP ツールの呼び出しを保護および監視するためのツールを提供し、MCP ドキュメントに記載されているベストプラクティスに準拠しています。自身を明かすことなく MCP 開発とやり取りできます。

🚀 クイックスタート

このShield MCP 防护中间件は、MCP サーバーのセキュリティと監視機能を強化するためのミドルウェアです。以下のコードで簡単に使い始めることができます。

from shieldmcp import ShieldMCP

# 初始化ShieldMCP
shield = ShieldMCP()

# 使用ShieldMCP装饰器保护MCP工具
@shield.protect
def sensitive_tool():
    # 工具逻辑
    pass

# 启动服务
if __name__ == "__main__":
    shield.start()

✨ 主な機能

• ツールアクセス制御：ホワイトリストベースの MCP ツールアクセス制御
• 結果浄化：MCP ツールの結果に対する機密情報処理
• 構造化ログ記録：構造化方式で操作ログを記録
• レート制限：高頻度呼び出し攻撃を防止
• エラー処理：例外とエラーを統一管理
• MCP Inspector との互換性：MCP 監視ツールとの統合をサポート

📦 インストール

# クローンする
git clone https://github.com/shieldmcp/shieldmcp.git
cd shieldmcp

# 仮想環境を作成してアクティブ化する
python -m venv venv
source venv/bin/activate  # または `venv\Scripts\activate` (Windowsの場合)

# 依存関係をインストールする
pip install -r requirements.txt

📚 ドキュメント

必要条件

システム要件

• オペレーティングシステム：Linux/Windows/MacOS
• Python バージョン：3.8+

依存関係

• python >= 3.8
• pytest テストフレームワーク
• その他の開発ツール（IDE、バージョン管理システムなど）

コンポーネント

デコレータ

MCP ツールのメソッドまたは関数を保護するためのもので、アクセス制御とレート制限を設定できます。

from shieldmcp import ShieldMCP

shield = ShieldMCP(
    allowed_users=["user1", "user2"],
    rate_limit=10  # 毎分最大10回の呼び出し
)

@shield.protect
def my_tool():
    pass

監査ログ記録

すべての機密操作のログを記録し、構造化出力をサポートします。

# 監査ログを設定する
shield.config_logging(
    log_file="audit.log",
    log_level=logging.INFO
)

アクセス制御

MCP ツールのアクセス権限を管理し、ユーザー、IP、時間などの複数のポリシーをサポートします。

# 許可されたユーザーを追加する
shield.add_allowed_user("user1")
shield.add_allowed_user("user2")

# 許可されていないユーザーを削除する
shield.remove_allowed_user("user3")

浄化器

MCP ツールの出力結果を浄化し、機密情報の漏洩を防止します。

from shieldmcp.sanitizer import TextSanitizer

sanitizer = TextSanitizer(
    patterns=[r"^\d{11}$"],  # 電話番号をマッチング
    replacement="PHONE_NUMBER"
)

clean_text = sanitizer.sanitize("你的电话是 12345678901")

レート制限

高頻度呼び出し攻撃を防止し、MCP サービスを保護します。

# レート制限を設定する
shield.config_rate_limit(
    rate=10,  # 毎分最大10回
    burst=2   # 突発的に2回許可
)

ベストプラクティス

ツールアクセス制御

• 定期的にホワイトリストを監査および更新する
• ツールの機密度に応じて適切なアクセス権限を設定する
• 多要素認証を使用してセキュリティを強化する

結果浄化

• すべてのテキスト出力を浄化処理する
• 隠す必要のある機密パターンを明確に定義する
• 適切な長さ制限を設定する

ログ記録

• ユーザーとセッション ID を記録する
• 成功と失敗した操作を監視する
• 分析しやすいように構造化ログを使用する

レート制限

• ツールの複雑さに応じて適切な制限を設定する
• 突発的な状況を考慮して適切な burst 値を設定する
• レート制限ポリシーのトリガー状況を監視する

開発

開発環境のセットアップ

# クローンする
git clone https://github.com/shieldmcp/shieldmcp.git
cd shieldmcp

# 仮想環境を作成してアクティブ化する
python -m venv venv
source venv/bin/activate  # または `venv\Scripts\activate` (Windowsの場合)

# 開発用の依存関係をインストールする
pip install -r requirements.txt

テストの実行

pytest tests/

ロードマップ

予定機能

• Clerk MCP と GitHub MCP をサポートする
• ドキュメント内容を拡張する
• TypeScript のサポートを追加する

謝辞

• Model Context Protocol がプロトコル仕様を提供
• structlog が構造化ログ記録を提供