Code Gen 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

______________________________________________________________________

🛠️ 发展

📖 ****

完整的部署指南，包括：

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

快速开始

# 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

______________________________________________________________________

📚 文档

有关详细文档，请参阅：

• docs/ -完整的文档
• 文档/协调员/ -协调员文件
• 文档/工作者/ -工人文件
• docs/local backlog/e2e-test-proposal.md -E2E测试实施

______________________________________________________________________

📄 许可证

Apache 2.0-请参阅 许可证 详情

版权所有©2025 AltairaLabs.ai