AIBD Dev Container

AIBD Dev Container

一个预配置的开发容器设置，可用于通过 Claude 辅助开发。它基于 VS Code Dev Containers，并集成了用于文件系统和 shell 操作的 Model Context Protocol (MCP) 服务。

概述

此仓库提供了一个开箱即用的开发容器，可用于：

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

先决条件

• Visual Studio Code
• VS Code Dev Containers extension
• 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 将构建并启动开发容器。首次启动时，此过程可能需要一些时间。之后启动会更快。

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 镜像
• 为 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

此脚本会启动 MCP 服务，以便 Claude 与你的代码交互。

许可证

本项目采用 MIT License。详情请参阅 LICENSE 文件。