AIBD开发容器
基于VS Code Dev Containers的Claude人工智能辅助开发预配置开发容器设置,集成 用于文件系统和shell的模型上下文协议(MCP)服务器 操作。
概述
此存储库提供了一个即用型开发容器,该容器:
- 创建一致、隔离的开发环境
- 通过MCP服务器与Claude Desktop无缝集成
- 使用Docker卷进行持久存储
- 适用于Windows(使用WSL2)、macOS和Linux
先决条件
- Visual Studio Code
- VS代码开发容器扩展
- 对于Windows用户: WSL2已启用
安装说明
1.克隆存储库
git clone https://github.com/gergelyszerovay/aibd-devcontainer.git
cd aibd-devcontainer2.在VS Code中打开
在Visual Studio Code中打开克隆的存储库。您应该会收到一条通知,询问您是否要重新打开容器中的文件夹。单击“在容器中重新打开”继续。
或者,您可以:
- 点击VS Code左下角的绿色按钮
- 从菜单中选择“在容器中重新打开”
3.等待集装箱建造
VS Code将构建并启动您的开发容器。首次发射时,此过程可能需要几分钟。后续启动将更快。
4.访问您的项目文件
容器创建了一个挂载在以下位置的Docker卷 /volume 容器内部:
cd volume这是您应该放置项目文件的地方。您可以:
- 克隆现有存储库:
git clone https://github.com/your-username/your-project.git - 直接在此目录中创建新文件
5.将克劳德连接到容器
要将Claude连接到您的开发容器:
- 通过将以下内容添加到您的
claude_desktop_config.json:
{
"mcpServers": {
"devcontainer": {
"command": "npx",
"args": ["-y", "supergateway", "--sse", "http://localhost:3100/sse"]
}
}
}- 重新启动Claude Desktop以建立连接
容器配置
开发容器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"
]
}此配置:
- 使用微软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文件。
