AIBD 开发容器

一个预配置的开发容器设置，用于使用 Claude 进行 AI 辅助开发，基于 VS Code Dev Containers，并集成了 用于文件系统和 shell 操作的模型上下文协议 (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 中打开克隆的存储库。您应该会收到一个通知，询问您是否要在容器中重新打开文件夹。单击“在容器中重新打开”以继续。

或者，您可以：

1. 单击 VS Code 左下角的绿色按钮
2. 从菜单中选择“在容器中重新打开”

3. 等待容器构建

VS Code 将构建并启动您的开发容器。首次启动时，此过程可能需要一些时间。后续启动会更快。

4. 访问您的项目文件

容器创建一个 Docker 卷，挂载在容器内的 /volume：

cd volume

您应该将项目文件放在这里。您可以：

• 克隆现有存储库：git clone https://github.com/your-username/your-project.git
• 直接在此目录中创建新文件

5. 将 Claude 连接到容器

要将 Claude 连接到您的开发容器：

1. 通过将以下内容添加到您的 claude_desktop_config.json，配置 Claude Desktop 以使用 MCP 服务器：

{
  "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 node:node ./

# 可以在此处添加其他设置命令

您可以自定义此脚本以安装其他工具或依赖项。

启动脚本

.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

此脚本启动 MCP 服务器，使 Claude 能够与您的代码进行交互。

许可证

本项目根据 MIT 许可证提供。有关更多详细信息，请参见 LICENSE 文件。