AIBD Dev Container

AIBD Dev Container

Claude を使った AI 支援開発向けに事前設定された開発コンテナー環境です。VS Code Dev Containers をベースに、ファイルシステムおよびシェル操作用の Model Context Protocol（MCP）サーバーを統合しています。

概要

このリポジトリでは、すぐに使える開発コンテナーを提供しています。このコンテナーは、次の機能を備えています。

• 一貫性のある分離された開発環境を構築します
• MCP サーバーを介して Claude Desktop とシームレスに連携します
• 永続ストレージに Docker ボリュームを使用します
• Windows（WSL2 使用）、macOS、Linux で動作します

前提条件

• Visual Studio Code
• VS Code Dev Containers 拡張機能
• Docker Desktop
• Windows ユーザーの場合：WSL2 の有効化

セットアップ手順

1. リポジトリをクローンする

git clone https://github.com/gergelyszerovay/aibd-devcontainer.git
cd aibd-devcontainer

2. VS Code で開く

クローンしたリポジトリを Visual Studio Code で開きます。フォルダーをコンテナー内で再度開くかどうかを尋ねる通知が表示されます。「Reopen in Container」をクリックして続行します。

または、次の手順でも操作できます。

1. VS Code の左下にある緑色のボタンをクリックします
2. メニューから「Reopen in Container」を選択します

3. コンテナーのビルドが完了するまで待つ

VS Code が開発コンテナーをビルドして起動します。初回起動時は、処理に少し時間がかかることがあります。2 回目以降の起動はより速くなります。

4. プロジェクトファイルにアクセスする

コンテナー内の /volume にマウントされた Docker ボリュームが作成されます。

cd volume

ここにプロジェクトファイルを配置してください。次のいずれかの方法を使えます。

• 既存のリポジトリをクローンする：git clone https://github.com/your-username/your-project.git
• このディレクトリに直接新しいファイルを作成する

5. Claude をコンテナーに接続する

Claude を開発コンテナーに接続するには、次の手順を実行します。

1. claude_desktop_config.json に次の内容を追加して、MCP サーバーを使用するよう Claude Desktop を設定します。

{
  "mcpServers": {
    "devcontainer": {
      "command": "npx",
      "args": ["-y", "supergateway", "--sse", "http://localhost:3100/sse"]
    }
  }
}

2. Claude Desktop を再起動して接続を確立します

コンテナーの設定

Dev Container JSON

.devcontainer/devcontainer.json ファイルで開発コンテナーを設定します。

{
  "name": "Node.js & TypeScript",
  "image": "mcr.microsoft.com/devcontainers/typescript-node:1-22-bookworm",
  "forwardPorts": [3100],
  "postCreateCommand": "bash .devcontainer/install.sh",
  "postStartCommand": "bash .devcontainer/start.sh",
  "mounts": [
    "source=${localWorkspaceFolderBasename}-volume,target=${containerWorkspaceFolder}/volume,type=volume"
  ]
}

この設定では、次のことを行います。

• 公式の Microsoft TypeScript/Node.js イメージを使用します
• MCP サーバー用にポート 3100 を転送します
• 作成後および起動ごとにセットアップスクリプトを実行します
• プロジェクトファイル用に永続 Docker ボリュームを作成します

インストールスクリプト

.devcontainer/install.sh スクリプトは、コンテナーの初回作成時に一度実行されます。

#/bin/sh

sudo chown -R node:node ./

# Additional setup commands can be added here

このスクリプトをカスタマイズして、ツールや依存関係を追加でインストールできます。

起動スクリプト

.devcontainer/start.sh スクリプトは、コンテナーの起動時に毎回実行されます。

#/bin/sh

npx -y @gergelyszerovay/mcp-server-aibd-devcontainer --enableHttpTransport=true --mcpHttpPort=3100 --enableStdioTransport=false --enableRestServer=true --restHttpPort=3101 --enableShellExecTool=true --allowed-directories=/workspaces

このスクリプトは、Claude がコードとやり取りできるようにする MCP サーバーを起動します。

ライセンス

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