🚀 AIBD 开发容器

这是一个基于 VS Code Dev Containers 的预配置开发环境，集成了 模型上下文协议 (MCP) 服务器，可用于 Claude 协助开发的文件系统和 Shell 操作。

🚀 快速开始

此仓库提供了一个现成的开发容器，具有以下功能：

• 创建一致且隔离的开发环境。
• 与 Claude Desktop 无缝集成，通过 MCP 服务器进行连接。
• 使用 Docker 卷实现持久化存储。
• 支持 Windows（需 WSL2）、macOS 和 Linux 系统。

✨ 主要特性

• 环境一致性：借助 VS Code Dev Containers 创建统一且隔离的开发环境，避免环境差异带来的问题。
• 集成 Claude：与 Claude Desktop 无缝集成，通过 MCP 服务器连接，方便进行开发辅助。
• 持久化存储：使用 Docker 卷实现持久化存储，确保项目文件不会丢失。
• 多系统支持：支持 Windows（需 WSL2）、macOS 和 Linux 系统。

📦 安装指南

先决条件

• Visual Studio Code
• VS Code 的 远程容器扩展
• Docker Desktop
• Windows 用户需启用 WSL2

安装步骤

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 镜像。
• 前向开放 3100 端口用于 MCP 服务器。
• 在容器创建后和每次启动时运行设置脚本。
• 创建持久 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 工具链。

⚠️ 注意事项

⚠️ 重要提示

容器内部的 Node.js 和 npm 版本由镜像决定，如需自定义请修改镜像配置。

💡 使用建议

建议在首次启动后运行 npm install 以确保项目依赖正确加载。