Mcp Server Aibd Devcontainer

DevContainer での AI 支援開発

DevContainer 環境での AI 支援開発を強化するために設計された MCP サーバーです。ファイルシステム操作と、AI アシスタントとコンテナ化された開発環境がシームレスに連携するためのツールを提供します。ファイルシステム操作は、Anthropic の Filesystem MCP サーバーに基づいています。

インストール

devcontainer で AI 支援開発を始める最も簡単な方法は、AIBD Devcontainer Repository のインストール手順に従うことです。このリポジトリには、MCP サーバーがあらかじめ統合された、事前設定済みの開発コンテナーが用意されています。

手順は次のとおりです。

1. aibd-devcontainer リポジトリをクローンします
2. VS Code で開き、「コンテナーで再度開く」機能を使用します
3. MCP サーバーに接続するよう Claude を設定します
4. AI の支援を受けながら開発を始めます

事前設定済みの環境では、MCP サーバーのセットアップ、ポート転送、ファイルアクセス権限など、必要な設定がすべて処理されます。

機能

• ファイルシステムのあらゆる操作（読み取り、書き込み、編集など）
• ディレクトリツリー
• ファイル検索とメタデータの取得
• 安全性を高める Plan モードと Act モード
• セキュリティのためのアクセス可能なディレクトリの制限
• SSE（Server-Sent Events）トランスポートのサポート。Docker 化された環境に最適です
• REST API
• オプションのシェルコマンド実行機能（デフォルトでは無効）

API

ツール

ファイルの読み取り

• read_multiple_files
  • 複数のファイルを同時に読み取ります
  • 入力：
    • paths（string[]）：読み取るファイルのパス
  • 戻り値：
    • 各パスとファイルの内容を含む配列

ファイルの書き込み／変更

• write_file

  • 新しいファイルを作成するか、既存のファイルを完全に上書きします
  • 入力：
    • path（string）：ファイルの書き込み先のパス
    • content（string）：ファイルに書き込む内容
  • 戻り値：
    • 確認メッセージ
  • 注：「mcpAct」モードでのみ使用できます

• edit_file

  • テキストファイルを行単位で編集します
  • 入力：
    • path（string）：編集するファイルのパス
    • edits（array）：編集操作の配列
    • dryRun（boolean）：書き込みを行わずに変更をプレビューします
  • 戻り値：
    • 変更を示す Git 形式の差分
  • 注：「mcpAct」モードでのみ使用できます

ディレクトリ操作

• create_directory

  • 新しいディレクトリを作成するか、ディレクトリが存在することを確認します
  • 入力：
    • path（string）：作成するパス
  • 戻り値：
    • 確認メッセージ
  • 注：「mcpAct」モードでのみ使用できます

• directory_tree

  • ファイルとディレクトリの再帰的なツリー表示を取得します
  • 入力：
    • path（string）：ルートパス
    • depth（number、任意）：再帰の最大深度（デフォルト：1）
  • 戻り値：
    • ディレクトリツリーを表す JSON 構造

ファイル管理

• move_file

  • ファイルやディレクトリを移動または名前変更します
  • 入力：
    • source（string）：移動元のパス
    • destination（string）：移動先のパス
  • 戻り値：
    • 確認メッセージ
  • 注：「mcpAct」モードでのみ使用できます

• delete_multiple_files

  • 複数のファイルを1回の操作で削除します
  • 入力：
    • paths（string[]）：削除するパス
  • 戻り値：
    • 成功と失敗の詳細なレポート
  • 注：「mcpAct」モードでのみ使用できます

ユーティリティ

• search_files

  • パターンに一致するファイルやディレクトリを再帰的に検索します
  • 入力：
    • path (string)：検索を開始するルートパス
    • pattern (string)：検索するパターン
    • excludePatterns (string[])：除外するパターン
  • 戻り値：
    • 一致したファイルパスの配列

• get_file_info

  • ファイルまたはディレクトリに関する詳細なメタデータを取得します
  • 入力：
    • path (string)：情報を取得するパス
  • 戻り値：
    • ファイルの詳細なメタデータ（サイズ、日付、権限など）

• list_allowed_directories

  • サーバーがアクセスを許可されているディレクトリの一覧を返します
  • 入力：なし
  • 戻り値：
    • 許可されたディレクトリパスの配列

シェル操作

• shell_exec
  • シェルでコマンドを実行し、出力を構造化データとして返します
  • 入力：
    • command (string)：実行するコマンド
    • timeout (number, optional)：最大実行時間（ミリ秒、デフォルト：5000）
  • 戻り値：
    • 次のプロパティを持つ JSON オブジェクト：
      • stdout (string)：コマンドの標準出力
      • stderr (string)：コマンドの標準エラー出力
      • exitCode (number)：コマンドの終了コード（成功時は0、失敗時は0以外）
  • 注：
  • サーバーの起動時に --enableShellExecTool フラグを指定した場合のみ利用できます
  • "mcpAct" モードでのみ利用できます
  • タイムアウトは設定可能で、最大300秒です

モード管理

• get_mode

  • 現在の動作モードを取得します
  • 入力：なし
  • 戻り値：
    • 現在のモード（"mcpAct" または "mcpPlan"）

• set_mode

  • 動作モードを設定します
  • 入力：
    • mode (string)：切り替え先のモード（"mcpAct" または "mcpPlan"）
  • 戻り値：
    • 確認メッセージ

Claude Desktop での使用方法

これを claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "aibd": {
      "command": "npx",
      "args": [
        "-y",
        "@gergelyszerovay/mcp-server-aibd-devcontainer",
        "--allowedDirectories=/your/allowed/path"
        // Add "--enableShellExecTool" here if you want to enable shell command execution
      ]
    }
  }
}

コマンドラインオプション

MCP server with filesystem tools.

Options
  --enableHttpTransport         Enable HTTP transport [default: false]
  --enableStdioTransport        Enable stdio transport [default: true]
  --enableRestServer            Enable REST API server [default: false]
  --enableShellExecTool              Enable shell execution tool [default: false]
  --mcpHttpPort=<port>          Port for MCP HTTP server [default: 3001]
  --restHttpPort=<port>         Port for REST HTTP server [default: 3002]
  --allowedDirectories=<path>   Allowed directories for filesystem access (multiple, required)
  --initialMode=<mode>          Initial operation mode: mcpAct or mcpPlan [default: mcpAct]
  --help                        Show this help message

Examples
  $ 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" モードでのみ利用可能
• 長時間実行されるプロセスを防ぐためのタイムアウト設定
• 応答が過剰に大きくなるのを防ぐ出力サイズ制限
• 終了コードを含むコマンド実行結果の完全な報告
• 診断を容易にする標準出力と標準エラー出力の分離
• コマンド失敗時のエラー処理

警告：シェル実行を有効にすると、モデルがシステム上で任意のコマンドを実行できるようになります。AI が生成したコマンドは、実行を許可する前に必ず慎重に確認してください。