AI开发容器

一个预配置的开发容器,用于AI辅助开发,集成了VS Code Dev Containers和MCP服务器,支持与Claude Desktop的无缝集成。

  • by gergelyszerovay
  • Shell
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 gergelyszerovay/aibd-devcontainer

使用说明

AIBD开发容器

基于VS Code Dev Containers的Claude人工智能辅助开发预配置开发容器设置,集成 用于文件系统和shell的模型上下文协议(MCP)服务器 操作。

概述

此存储库提供了一个即用型开发容器,该容器:

  • 创建一致、隔离的开发环境
  • 通过MCP服务器与Claude Desktop无缝集成
  • 使用Docker卷进行持久存储
  • 适用于Windows(使用WSL2)、macOS和Linux

先决条件

安装说明

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连接到您的开发容器:

  1. 通过将以下内容添加到您的 claude_desktop_config.json:
{
  "mcpServers": {
    "devcontainer": {
      "command": "npx",
      "args": ["-y", "supergateway", "--sse", "http://localhost:3100/sse"]
    }
  }
}
  1. 重新启动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文件。