Command Security Layer

🚀 MCP コマンドサーバー

安全なモデルコンテキストプロトコル（MCP）サーバーで、Claudeなどの大規模言語モデルアプリケーションを通じてシステムコマンドを実行できます。

🚀 クイックスタート

1. パッケージのインストール

uv pip install mcp-command-server

2. 許可するコマンドの設定

export ALLOWED_COMMANDS="ls,pwd,echo"

3. Claude Desktopの設定に追加

{
  "mcpServers": {
    "command-server": {
      "command": "uv",
      "args": ["run", "python", "-m", "mcp_command_server"],
      "env": {
        "ALLOWED_COMMANDS": "ls,pwd,echo"
      }
    }
  }
}

✨ 主な機能

• 🔒 ホワイトリスト付きの安全なコマンド実行
• ✅ すべてのコマンドに対するユーザー確認
• 📝 包括的な監査ログ記録
• 🔍 入力検証とクリーニング
• 🤖 Claude Desktopとの統合

📚 ドキュメント

完全なドキュメントについては、docs/ディレクトリを参照してください。

• インストールガイド
• セキュリティガイド
• APIリファレンス
• 使用例
• トラブルシューティング

🔧 開発

セットアップ

# リポジトリをクローン
git clone https://github.com/yourusername/mcp-command-server.git
cd mcp-command-server

# 仮想環境を作成
uv venv
source .venv/bin/activate  # Unix/macOSでの実行
.venv\Scripts\activate     # Windowsでの実行

# 開発用の依存関係をインストール
uv pip install -e ".[dev]"

テスト

# すべてのテストを実行
pytest

# 特定のテストファイルを実行
pytest tests/unit/security/test_validator.py

# カバレッジを含めて実行
pytest --cov=mcp_command_server

コントリビュート

1. リポジトリをフォークしてクローンする
2. 機能ブランチを作成する
3. テストとコードチェックを実行する
4. プルリクエストを提出する

📄 ライセンス

MITライセンス - 詳細はLICENSEを参照してください。