Aibd Devcontainer

🚀 AIBD 開発コンテナ

このプロジェクトは、VS Code Dev Containers をベースにした事前構成済みの開発環境です。モデルコンテキストプロトコル (MCP) サーバー を統合しており、Claude を使ったファイルシステムとシェル操作の開発を支援します。

🚀 クイックスタート

このリポジトリは、以下の機能を備えた開発コンテナを提供します。

• 一貫性のある隔離された開発環境を作成する。
• MCP サーバーを介して、Claude Desktop とシームレスに統合する。
• Docker ボリュームを使用して永続的なストレージを実現する。
• Windows（WSL2 が必要）、macOS、Linux システムをサポートする。

✨ 主な機能

• 一貫性のある隔離された開発環境を提供する。
• Claude Desktop とのシームレスな統合。
• Docker ボリュームによる永続的なストレージ。
• 複数のオペレーティングシステムをサポート。

📦 インストール

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

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

2. VS Code で開く

クローンしたリポジトリをターミナルで開くと、VS Code がコンテナにフォルダを再開するかどうかを尋ねます。「コンテナで再開」をクリックして続行します。 または、以下の手順で操作することもできます。

1. VS Code の左下の緑色のボタンをクリックします。
2. メニューから「コンテナで再開」を選択します。

3. コンテナの構築が完了するまで待つ

VS Code が開発コンテナを構築して起動します。初回実行時は数分かかる場合があります。以降の起動は高速になります。

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

コンテナは /volume ディレクトリに Docker ボリュームをマウントしています。

cd volume

このディレクトリにプロジェクトファイルを配置することができます。

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

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

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

1. Claude Desktop が MCP サーバーを使用するように構成し、claude_desktop_config.json ファイルに以下の内容を追加します。

{
  "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 $USER:$GROUPS /volume

これにより、/volume ディレクトリに正しいユーザー権限が付与されます。

起動スクリプト

.devcontainer/start.sh スクリプトは、コンテナが起動するたびに実行されます。

#!/bin/bash

npm install -g typescript@latest ts-node@latest

これにより、最新の TypeScript と ts-node ツールチェーンがインストールされます。

🔧 技術詳細

コンテナ構成

• イメージ: 公式の Microsoft TypeScript/Node.js イメージを使用しています。
• ポート転送: 3100 ポートが MCP サーバー用に開放されています。
• スクリプト: コンテナの作成後と起動時に設定スクリプトが実行されます。
• ボリューム: プロジェクトファイルを保存するための永続的な Docker ボリュームが作成されます。

依存関係

• Node.js と npm のバージョンはイメージによって決まります。必要に応じてイメージ構成を変更してください。
• 初回起動後に npm install を実行することをおすすめします。

注意事項

⚠️ 重要提示

コンテナ内の Node.js と npm のバージョンはイメージによって決まります。カスタマイズする場合は、イメージ構成を変更してください。

💡 使用建议

初回起動後に npm install を実行して、プロジェクトの依存関係を正しく読み込んでください。