MCP Command Server

🚀 MCP命令サーバー

安全なモデルコンテキストプロトコル（MCP）サーバーです。ClaudeなどのLLMアプリケーションを通じてシステムコマンドを実行するために使用されます。

🚀 クイックスタート

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

uv pip install mcp-command-server

2. 許可されたコマンドの設定

export ALLOWED_COMMANDS="ls,pwd,echo"

3. Claudeデスクトップ設定への追加

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

✨ 主な機能

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

📚 ドキュメント

完全なドキュメントについては、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を参照してください。