MCP Bash

🚀 MCP Bash

このプロジェクトは、シンプルなモデルコンテキストプロトコル（MCP）サーバーで、bash コマンドを実行することができます。MCP サーバーインターフェースを通じて任意の bash コマンドを実行できますが、それには潜在的なセキュリティリスクが伴います！作成時に似たようなものが公開されていなかったため、独自に作成しました。Claude Desktop でコードを記述する際に非常に便利です（テストの実行、結果の評価、問題の修正が可能）。

🚀 クイックスタート

MCP Bash は、クライアントアプリケーションから bash コマンドを実行する簡単な方法を提供します。コマンドの実行を制御された環境にラップし、実行されたコマンドの標準出力と標準エラーを返します。

✨ 主な機能

• 任意の bash コマンドを実行する
• コマンド実行間で作業ディレクトリを設定し、保持する
• モデルコンテキストプロトコル（MCP）を通じてクリーンなインターフェースを提供する
• デプロイが簡単で、拡張しやすい

📦 インストール

前提条件

• Python 3.10 以上
• pip またはその他のパッケージマネージャー

セットアップ

1. リポジトリをクローンします。

   git clone https://github.com/yourusername/mcp-bash.git
   cd mcp-bash
   

2. 仮想環境を作成し、アクティブ化します。

   python -m venv .venv
   source .venv/bin/activate  # Windowsの場合は：.venv\Scripts\activate
   

3. 依存関係をインストールします。

   pip install -e .
   

💻 使用例

サーバーの起動

python -m mcp.cli.server --module server

Claude Desktop との連携設定

Claude Desktop と連携する場合は、以下の内容を設定ファイルに追加してください（通常は /Users//Library/Application Support/Claude/claude_desktop_config.json、または Claude Desktop UI の「設定 -> 開発者」で確認できます）。

{
  "mcpServers": {
    "Bash": {
      "command": "/Users/<username>/.local/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/path/to/server.py"
      ]
    }
  }
}

その後、Claude に「Bash MCP ツールを使って現在のディレクトリのファイルをリストアップする」と要求します。

API の使用

サーバーは、以下の 2 つの主要な機能を公開しています。

1. set_cwd(path)：bash コマンドの作業ディレクトリを設定します。
2. execute_bash(cmd)：bash コマンドを実行し、stdout/stderr を返します。

クライアントコードの例

from mcp.client import MCPClient

async def main():
    # MCP サーバーに接続します。
    client = MCPClient("http://localhost:8000")
    
    # 作業ディレクトリを設定します。
    await client.set_cwd("/path/to/your/directory")
    
    # コマンドを実行します。
    stdout, stderr = await client.execute_bash("ls -la")
    
    print(f"コマンド出力：{stdout}")
    if stderr:
        print(f"エラー出力：{stderr}")

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

基本的な使用法

上記のクライアントコードは、MCP サーバーに接続し、作業ディレクトリを設定し、bash コマンドを実行する基本的な使用方法を示しています。

高度な使用法

サーバーの API を利用して、複雑なコマンドの実行や、コマンドの連続実行など、高度な操作が可能です。

🔧 技術詳細

このサーバーは直接 bash コマンドを実行するため、制限を設けない場合、重大なセキュリティリスクとなります。LLM には、rm -rf / のような危険なコマンドを実行することを阻止する機能はありません。個人使用では、利便性がリスクを上回るかもしれませんが、デプロイする際には注意してください。

考慮事項：

• コンテナまたは制限付き環境で実行する
• コマンドの検証または許可リストを追加する
• 適切なユーザー権限でファイルシステムへのアクセスを制限する

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については、LICENSE ファイルを参照してください。

貢献

貢献は大歓迎です！自由にプルリクエストを送信してください。