MCP Server Aibd Devcontainer

🚀 AI 強化開発環境における DevContainer

AI 強化開発環境での DevContainer を利用した MCP サーバーのファイルシステムツールについて説明します。このツールは、開発環境の操作を効率化し、安全に行うための機能を提供します。

🚀 クイックスタート

Claude Desktop で MCP サーバーを使用するには、claude_desktop_config.json に以下の設定を追加してください。

{
  "mcpServers": {
    "aibd": {
      "command": "npx",
      "args": [
        "-y",
        "@gergelyszerovay/mcp-server-aibd-devcontainer",
        "--allowedDirectories=/your/allowed/path"
        // シェルコマンド実行ツールを有効にする場合は、"--enableShellExecTool" をここに追加します
      ]
    }
  }
}

📦 インストール

Claude Desktop で MCP サーバーを使用するには、claude_desktop_config.json ファイルに特定の設定を追加する必要があります。以下の JSON コードを該当ファイルに追加してください。

{
  "mcpServers": {
    "aibd": {
      "command": "npx",
      "args": [
        "-y",
        "@gergelyszerovay/mcp-server-aibd-devcontainer",
        "--allowedDirectories=/your/allowed/path"
        // シェルコマンド実行ツールを有効にする場合は、"--enableShellExecTool" をここに追加します
      ]
    }
  }
}

💻 使用例

基本的な使用法

以下は、MCP サーバーの基本的なコマンドラインオプションの使用例です。

MCPファイルシステムツールサーバー。

オプション：
  --enableHttpTransport         HTTPトランスポートを有効にする [デフォルト: false]
  --enableStdioTransport        stdioトランスポートを有効にする [デフォルト: true]
  --enableRestServer            REST APIサーバーを有効にする [デフォルト: false]
  --enableShellExecTool         シェルコマンド実行ツールを有効にする [デフォルト: false]
  --mcpHttpPort=<ポート>          MCP HTTPサーバーのポート [デフォルト: 3001]
  --restHttpPort=<ポート>         REST HTTPサーバーのポート [デフォルト: 3002]
  --allowedDirectories=<パス>   アクセスを許可するディレクトリ（複数可、必須）
  --initialMode=<モード>          初期操作モード：mcpActまたはmcpPlan [デフォルト: mcpAct]
  --ヘルプ                        このヘルプ情報を表示する

例：
  $ mcp-fs --allowedDirectories=. --enableHttpTransport
  $ mcp-fs --allowedDirectories=/home/user/projects --mcpHttpPort=3005 --restHttpPort=3006
  $ mcp-fs --allowedDirectories=/path/to/dir1 --allowedDirectories=/path/to/dir2
  $ mcp-fs --allowedDirectories=. --initialMode=mcpPlan
  $ mcp-fs --allowedDirectories=. --enableShellExecTool

📚 ドキュメント

セキュリティとデプロイ

操作モード

サーバーは 2 つの操作モードを実装しています。

• mcpPlan モード：読み取り専用の分析モードで、モデルが環境を分析することはできますが、何らかの変更を加えることはできません。
• mcpAct モード：実行モードで、システムの変更機能に完全なアクセス権が与えられます。

この分離により、意図しないファイルシステムの変更に対する安全バリアが追加されます。

ディレクトリ制限

すべての操作は、起動時に指定された許可されたディレクトリ内に制限されます。これらのディレクトリ外のファイルにアクセスしようとすると、エラーが発生します。

シェルコマンド実行のセキュリティ

シェルコマンド実行ツールはデフォルトで無効になっており、--enableShellExecTool フラグを明示的に指定することで有効にできます。有効にすると、以下のセキュリティ機能が提供されます。

• 「mcpAct」モードでのみ使用可能で、計画モードでは使用できません。
• 長時間実行されるプロセスを防ぐためのタイムアウトを設定できます。
• 情報の過負荷を防ぐための出力サイズ制限があります。
• 終了コードを含む完全なコマンド実行結果のレポートが提供されます。
• 診断を容易にするために、stdout と stderr のストリームが分離されています。
• コマンドの失敗に対する手動処理が可能です。

⚠️ 重要提示

シェルコマンド実行を有効にすると、モデルがシステム上で任意のコマンドを実行する能力が与えられます。AI が生成したコマンドを実行する前に、必ず慎重にレビューしてください。