Aibd Devcontainer

🚀 AIBD 开发容器

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

🚀 快速开始

此仓库提供了一个现成的开发容器，具备创建一致且隔离的开发环境、与 Claude Desktop 无缝集成、使用 Docker 卷实现持久化存储以及支持 Windows（需 WSL2）、macOS 和 Linux 系统等功能。

📦 安装指南

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 以确保项目依赖正确加载。