Cli MCP Server

🚀 CLI MCP サーバー

安全なモデルコンテキストプロトコル（MCP）サーバー実装で、包括的なセキュリティ機能を備えたコマンド実行を可能にします。このサーバーは、モデルコンテキストプロトコルを通じたやり取り用に設計されています。

🚀 クイックスタート

この CLI MCP サーバーは、モデルコンテキストプロトコルを通じて安全で機能豊富なコマンド実行環境を提供することを目的としています。コマンドホワイトリスト、フラグ検証、パストラバーサル防止などの機能をサポートし、制御された環境でコマンドを実行できます。

✨ 主な機能

• コマンドホワイトリスト：実行可能なコマンドとそれがサポートするフラグを指定できます。
• フラグ検証：使用されるフラグが期待通りであることを確認します。
• パストラバーサル防止：相対パスやシンボリックリンクを通じた悪意のある操作を防止します。
• シェル演算子ブロック：;、& などの危険なシェル演算子の使用を禁止します。
• コマンド長制限：長すぎるコマンドによるセキュリティリスクを防止します。
• 実行タイムアウト：コマンドの最大許容実行時間を設定し、長時間応答しないコマンドを防止します。
• 作業ディレクトリ制限：コマンドを指定された作業ディレクトリ内に制限し、越界アクセスを防止します。

📦 インストール

依存関係のインストール

以下のコマンドを使用してプロジェクトの依存関係をインストールします。

pip install -r requirements.txt

サーバーの起動

MCP サーバーを起動するには、次のコマンドを実行します。

python cli_mcp_server.py

📚 ドキュメント

設定

サーバーは、以下の環境変数を使用して設定できます。

利用可能なツール

1. run_command

制御された環境でコマンドを実行するためのツールです。以下の操作をサポートしています。

• 許可されたコマンドの実行。
• フラグの有効性の検証。
• パスの安全性の確保。

入力形式

{
  "command": "echo",
  "args": ["hello", "world"],
  "flags": ["-n"]
}

2. show_security_rules

現在のサーバーのセキュリティポリシー設定を表示します。許可されたコマンド、フラグ、作業ディレクトリ制限などが含まれます。

Claude デスクトップとの使用

Claude デスクトップ環境でこのサーバーを統合する場合は、以下の手順で設定してください。

開発モード

{
  "mcpServers": {
    "cli-mcp-server": {
      "command": "uv",
      "args": ["run", "cli-mcp-server"],
      "env": {
        "ALLOWED_COMMANDS": "echo,ls,-h",
        "ALLOWED_FLAGS": "-l,-a,--help,--version",
        "MAX_COMMAND_LENGTH": "1024",
        "COMMAND_TIMEOUT": "30"
      }
    }
  }
}

リリースモード

{
  "mcpServers": {
    "cli-mcp-server": {
      "command": "uvx",
      "args": ["cli-mcp-server"],
      "env": {
        "ALLOWED_COMMANDS": "echo,ls,-h",
        "ALLOWED_FLAGS": "-l,-a,--help,--version",
        "MAX_COMMAND_LENGTH": "1024",
        "COMMAND_TIMEOUT": "30"
      }
    }
  }
}

セキュリティ機能

• コマンドホワイトリスト：実行可能なコマンドを厳密に制限します。
• フラグ検証：使用されるフラグが期待通りであることを確認します。
• パストラバーサル防止：相対パスやシンボリックリンクを通じた悪意のある操作を防止します。
• シェル演算子ブロック：;、& などの危険なシェル演算子の使用を禁止します。
• コマンド長制限：長すぎるコマンドによるセキュリティリスクを防止します。
• 実行タイムアウト：コマンドの最大許容実行時間を設定し、長時間応答しないコマンドを防止します。
• 作業ディレクトリ制限：コマンドを指定された作業ディレクトリ内に制限し、越界アクセスを防止します。

エラー処理

サーバーは、以下の状況を処理するための詳細なエラーメッセージを提供します。

• セキュリティ違反（CommandSecurityError）
• コマンドタイムアウト（CommandTimeoutError）
• 無効なコマンド形式
• パスセキュリティ違反
• 実行失敗

エラーメッセージは、標準出力または環境変数を通じて報告されます。

このドキュメントでは、MCP サーバーの設定と使用方法について詳しく説明しています。詳細な情報が必要な場合は、ソースコードを参照するか、開発チームに連絡してください。