AI导哈

代码生成沙箱服务

AltairaLabs CodeGen MCP 是一个开源的分布式执行层，允许LLM在隔离的沙箱中安全地生成、编辑和测试代码，通过Model Context Protocol (MCP)提供轻量级的CI系统功能。

  • by AltairaLabs
  • Go
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 AltairaLabs/CodeGen-MCP

使用说明

AltairaLabs CodeGen MCP

分布式沙箱和模型上下文协议（MCP）提供程序，用于LLM驱动的代码生成和测试。

🧩 概述

AltairaLabs CodeGen MCP是一个开源软件 分布式执行层 这允许LLM在隔离的沙箱中安全地生成、编辑和测试代码——所有这些都是通过 模型上下文协议（MCP）.

它提供了一个 MCP提供者和运行时 其工作原理类似于代理的轻量级CI系统：

  • 协调池 基于Docker的worker代理
  • 协调员服务 暴露MCP端点
  • 安全、短暂 代码沙箱
  • 可选的 共享文件系统或对象存储 为了恢复
  • 直接集成 PromptKit/竞技场 工作流

🏗️ 建筑

flowchart TB
    subgraph Coordinator["🧠 CodeGen Coordinator (Control Plane)"]
        MCP["MCP Server (public endpoint)"]
        Router["Session Router & Registry"]
        Store["Session Store (Redis/Postgres)"]
    end

    subgraph Worker["⚙️ Docker Worker Agent (Data Plane)"]
        API["Agent API (gRPC)"]
        Sandbox["Per-Session Sandboxes"]
        Vol["Ephemeral FS (mounted volume or object storage)"]
    end

    subgraph Client["🗣️ LLM / PromptKit Runtime"]
        Arena["Arena / PromptPack Workflow"]
    end

    Client -->|"MCP Calls"| MCP
    MCP --> Router
    Router -->|Route Command| API
    API --> Sandbox
    Sandbox --> Vol
    API --> Router
    Router --> Store
    Router -->|Stream Results| MCP
    MCP --> Client

🛠️ 发展

📖 Docker编写入门指南

完整的部署指南，包括：

  • 🚀 快速启动说明
  • 📊 架构图
  • ⚙️ 配置选项
  • 🧪 测试和故障排除
  • 🔧 开发工作流程

快速开始

# Clone the repository
git clone https://github.com/AltairaLabs/codegen-mcp.git
cd codegen-mcp

# Run the full CI pipeline locally
make ci

可用生成目标

make help              # Show all available targets
make install           # Install dependencies and protoc plugins
make build             # Build coordinator and worker binaries
make test              # Run all tests
make test-unit         # Run tests with coverage (used in CI)
make lint              # Run linters (development mode)
make lint-ci           # Run linters in strict mode (used in CI)
make coverage          # Generate coverage report
make ci                # Run full CI pipeline locally
make clean             # Clean build artifacts

CI管道

GitHub Actions CI管道使用make目标来实现一致性：

  1. 测试工作: make install → make test-unit
  2. 棉绒工作: make install → make lint-ci
  3. 构建作业: make install → make build

在本地模拟CI管道，只需运行：

make ci

这与CI执行相同的步骤：

  • 安装依赖项
  • 生成二进制文件
  • 运行覆盖率测试
  • 以严格模式运行过梁

先决条件

  • 转到1.25+
  • 协议缓冲区编译器 (protoc)
  • 戈朗茨皮棉 对于linting

覆盖

当前测试覆盖率： ~85%

make coverage

查看详细报道：

go tool cover -html=coverage.out

📚 文档

有关详细文档，请参阅：

📄 许可证

Apache 2.0-请参阅 许可证 详情

版权所有©2025 AltairaLabs.ai

相关 MCP