Dev Guardian

DevGuardian MCP服务器——v3自主工程生态系统

使用Gemini 2.0 Flash和UV构建的AI驱动、项目感知的编码助理MCP服务器。\ 将其插入Antigravity或Claude Desktop，组建一个完整的人工智能工程团队：调试、审查、测试、部署和保护您的代码——所有这些都是自主的。

DevGuardian Demo

______________________________________________________________________

DevGuardian是什么？

DevGuardian v3是一个多智能体自主工程生态系统。它远远超出了单个脚本的范围——它在行动之前读取整个项目结构，使用一组人工智能代理迭代验证工作，现在主动修复自己的CI故障。

核心设计原则：

1. DNA意识项目 --在编写一行代码之前，DevGuardian会阅读您的README， pyproject.toml、完整文件树和导入图。它生成适合您架构的代码，而不是通用的样板。
2. Agent Swarm与对手评论 --3代理管道（编码器→ 测试员→ Review）循环，直到代码准备好生产。如果审阅者拒绝了代码，它会将特定的反馈发送回编码者进行另一次迭代（最多3次迭代）。
3. 语义记忆 --DevGuardian会记住您的编码风格偏好和在会话中吸取的经验教训，并存储在本地 .devguardian_memory.json.
4. 沙盒执行 --Tester代理实际上在一个安全的子流程中运行生成的代码，以捕获运行时错误，而不仅仅是直观地查找它们。
5. 自我修复CI --如果推 main 如果CI检查失败，修复作业会自动触发DevGuardian诊断并修复问题，然后重新推送修复提交。

______________________________________________________________________

工具参考（31个工具）

自主代理

AI代码智能

质量和测试

DevOps和基础设施

架构和文档

大规模运营

安全

Git套件

______________________________________________________________________

设置

先决条件

• 紫外线 安装
• Python 3.10+
• Git已安装
• A. Gemini API密钥 （免费）

安装

cd DevGuardian
uv venv
uv pip install -e .

配置API密钥

copy .env.example .env
# Open .env and paste your Gemini API key
# Optionally add GITHUB_TOKEN for private repo PR reviews

测试服务器运行情况

uv run devguardian

您应该看不到任何错误——服务器在stdio上等待MCP连接。

______________________________________________________________________

MCP配置

反重力（VS代码）

添加到您的 .gemini/settings.json:

{
  "mcpServers": {
    "devguardian": {
      "command": "uv",
      "args": ["--directory", "C:\\Users\\ASUS\\OneDrive\\Desktop\\DevGuardian", "run", "devguardian"],
      "env": {
        "GEMINI_API_KEY": "your_key_here",
        "GITHUB_TOKEN": "your_github_token_here"
      }
    }
  }
}

克劳德桌面

添加 %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "devguardian": {
      "command": "uv",
      "args": ["--directory", "C:\\Users\\ASUS\\OneDrive\\Desktop\\DevGuardian", "run", "devguardian"],
      "env": {
        "GEMINI_API_KEY": "your_key_here"
      }
    }
  }
}

______________________________________________________________________

用法示例

Agent Swarm——用3个AI Agent构建一个功能

“DevGuardian，使用代理群为我们的API创建一个速率限制实用程序。”\ 程序员写一个 RateLimiter 类。测试员发现边缘情况。审阅者拒绝并发送反馈。编码器修复。审阅者在第2遍中接受。返回最终生产就绪文件。

TDD自动驾驶——测试驱动的bug修复

“在上运行test_and_fix devguardian/tools/debugger.py"\ DevGuardian编写pytest测试，运行它们，读取失败，修补源代码，并循环直到所有测试都变绿。

PR审查——审查任何实时拉取请求

“回顾myorg/myrepo的PR#42”\ DevGuardian从GitHub获取差异，并生成一份涵盖错误、安全性、性能和风格的结构化审查。

架构图——可视化您的代码库

“为此项目生成架构图。”\ DevGuardian扫描所有内部导入，并生成一个Mermaid.js依赖关系图，显示每个文件如何连接到其他文件。

Smart.gitignore——上下文感知生成

“为此项目生成gitignore。”\ DevGuardian读取您的技术堆栈和文件结构。在包括之前，它会征求您的许可 .env 模式，然后生成一个定制的文件，而不是通用的模板。

安全推送代码

“将我的更改推送到main。”\ DevGuardian扫描所有暂存文件。如果检测到硬编码的API密钥或令牌，它将阻止推送并报告确切的文件和行号。

______________________________________________________________________

项目结构

DevGuardian/
├── .env.example                   Copy to .env and add your API key
├── .gitignore                     Security-focused ignore rules
├── pyproject.toml                 UV project config and dependencies
├── Dockerfile                     Production container
├── docker-compose.yml             Service orchestration
├── README.md
├── tests/
│   └── test_debugger.py           TDD-generated test suite
├── .github/
│   └── workflows/
│       └── ci.yml                 GitHub Actions CI/CD with self-healing job
└── devguardian/
    ├── server.py                  MCP server entry point (31 tools)
    ├── agents/
    │   ├── engineer.py            Stateful LangGraph autonomous agent
    │   └── swarm.py               3-Agent Swarm v3 with adversarial loops
    ├── tools/
    │   ├── debugger.py            debug_error
    │   ├── code_helper.py         explain, review, generate, improve
    │   ├── git_ops.py             Full git suite + smart_commit
    │   ├── tdd.py                 TDD Auto-Pilot
    │   ├── github_review.py       GitHub PR Reviewer
    │   ├── infra.py               Dockerfile, CI/CD, and gitignore generators
    │   ├── architect.py           Architecture mapping and technical docs
    │   ├── self_healing.py        CI failure detection and repair engine
    │   └── mass_refactor.py       Mass codebase refactoring
    └── utils/
        ├── gemini_client.py       Gemini 2.0 Flash wrapper
        ├── file_reader.py         Project DNA context builder
        ├── security.py            Pre-push security gate and .env validator
        ├── memory.py              Persistent semantic memory (JSON-based)
        └── executor.py            Safe subprocess execution sandbox

______________________________________________________________________

安全模型

• 防泄漏护罩: security.py 检测20多种凭据类型（AWS、GitHub、OpenAI、Google、Stripe、Slack） git push 或 smart_commit.
• 精确检测：仅标记硬编码的引用值——上没有误报 os.getenv() 电话。
• 环境安全: validate_env 查看您的 .env 文件结构——显示键，但从不公开值。
• 基于权限的Gitignore：The generate_gitignore 工具在添加之前要求明确的用户权限 .env 模式——没有你的批准，什么都不会做。
• 本地执行：除了Gemini API调用之外，您的代码永远不会离开您的机器。

______________________________________________________________________

CI/CD管道

管道在每次推拉请求时运行 main:

1. 棉绒 --Ruff检查代码样式和格式
2. 测试 --Pytest运行覆盖率高的完整测试套件
3. 自愈修复 --仅当lint或测试失败时触发。使用Agent Swarm自动诊断、修复和重新推送修复提交。
4. 构建 --构建Python包
5. 码头工人 --构建Docker镜像

______________________________________________________________________

码头工人

docker compose up --build

______________________________________________________________________

*由Karan使用Gemini 2.0 Flash、LangGraph、MCP SDK和UV构建。*