AIBD 开发容器

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

概述

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

• 创建一致、隔离的开发环境
• 与 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 以确保项目依赖正确加载。