MCP Cicd Agent

MCP CI/CD代理

MCP服务器，允许LLM代理运行完整的Docker CI/CD管道——从Git克隆到活动容器。

给Claude一个Git仓库URL——它会为您克隆、构建、部署和验证容器

MCP CI/CD Agent Demo

______________________________________________________________________

它的作用

你把克劳德指向一个仓库。Claude通过模型上下文协议自主运行整个管道。

"Deploy the latest version of my API from github.com/myorg/myapi"

  User ──► Claude AI ──► MCP Server ──► Docker ──► Running Container
 (prompt)  (orchestrates)  (8 tools)    (build)    (localhost:8080)

特性

• 一次对话中的完整管道 --克隆、检测、构建、部署、验证、回滚
• 8个MCP工具 --每个步骤都是一个明确的、可观察的工具调用
• 港口冲突解决 --自动查找可用端口
• 部署状态跟踪 --JSON状态文件支持回滚到任何以前的部署
• 缺省安全 --仅本地主机绑定， no-new-privileges，512 MB内存上限
• 结构化日志记录 --每个操作的JSON日志，易于管道到任何日志聚合器
• 101个单元测试 --全面覆盖验证、Git、Docker和设置层

快速开始

先决条件

• Python 3.10+
• Docker 20.10+（守护进程正在运行）
• 克劳德桌面

安装

git clone https://github.com/kratosvil/mcp-cicd-agent.git
cd mcp-cicd-agent
python -m venv .venv

# Windows
.venv\Scripts\activate

# Linux / macOS
source .venv/bin/activate

pip install -e .

配置Claude桌面版

添加到您的Claude Desktop配置文件中：

{
  "mcpServers": {
    "cicd-agent": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": ["-m", "mcp_cicd"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Windows示例 ``json "command": "C:\\Users\\you\\mcp-cicd-agent\\.venv\\Scripts\\python.exe" ``

重新启动Claude Desktop，然后尝试：

"Clone https://github.com/myorg/myapi and deploy it"

MCP工具

建筑

Claude Desktop
     │
     │  MCP Protocol (JSON-RPC 2.0 via stdio)
     ▼
┌──────────────────────────────────┐
│  MCP CI/CD Server (FastMCP)      │
│                                  │
│  repo_tools   ──► GitPython      │
│  docker_tools ──► Docker SDK     │
│  health_tools ──► httpx          │
│  lifecycle_tools ──► state mgr   │
└──────┬───────────────────────────┘
       │
       ▼
   Docker Engine
   ├── Image build (Dockerfile)
   └── Container run
          └── 127.0.0.1:
  (localhost only)

• 协议：JSON-RPC 2.0通过标准输入
• 状态：中的原子JSON文件 deployments/ （忽略）
• 工作区：中的每个提交目录都是隔离的 workspace/ （忽略）
• 安全: no-new-privileges:true, mem_limit=512m, 127.0.0.1 仅限绑定

测试

# Run all 101 unit tests
pytest tests/unit/ -v

# Run with coverage report
pytest tests/unit/ --cov=src/mcp_cicd --cov-report=term-missing

# Run integration tests (requires Docker daemon)
pytest tests/integration/ -v

# Run a specific group
pytest tests/unit/ -v -k "TestValidateGitUrl"
pytest tests/unit/ -v -k "TestDockerUtils"

单元测试使用模拟的Docker和Git调用——不需要运行Docker实例。

项目结构

mcp-cicd-agent/
├── src/mcp_cicd/
│   ├── tools/             # MCP tool implementations (8 tools)
│   │   ├── repo_tools.py
│   │   ├── docker_tools.py
│   │   ├── health_tools.py
│   │   └── lifecycle_tools.py
│   ├── models/            # Pydantic data models
│   ├── utils/             # Docker, Git, validation, state helpers
│   └── config/            # Settings via pydantic-settings + .env
├── tests/
│   ├── unit/              # 101 unit tests (mocked)
│   ├── integration/       # End-to-end pipeline tests (Docker required)
│   └── fixtures/          # Test app (simple Python HTTP server)
├── workspace/             # Git clone target (gitignored)
├── deployments/           # Deployment state JSON files (gitignored)
└── logs/                  # Application logs (gitignored)

配置

所有设置都可以通过环境变量或 .env 文件：

技术栈

关於 GitPython |HTTP|httpx（异步健康检查）| |验证| Pydantic v2+Pydantic设置| |测试|pytest/pytest异步|

许可证

麻省理工学院