MCP Command Server

MCP コマンドサーバー

Claude などの LLM アプリケーションを通じてシステムコマンドを実行するための、安全な Model Context Protocol（MCP）サーバーです。

クイックスタート

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 リファレンス
• 使用例
• トラブルシューティング

開発

セットアップ

# Clone repository
git clone https://github.com/yourusername/mcp-command-server.git
cd mcp-command-server

# Create virtual environment
uv venv
source .venv/bin/activate  # On Unix/macOS
.venv\Scripts\activate     # On Windows

# Install development dependencies
uv pip install -e ".[dev]"

テスト

# Run all tests
pytest

# Run specific test file
pytest tests/unit/security/test_validator.py

# Run with coverage
pytest --cov=mcp_command_server

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. テストとリンティングを実行します
4. プルリクエストを送信します

ライセンス

MIT License — 詳細は LICENSE をご覧ください。