AI导哈

自主工程生态系统服务器

DevGuardian MCP Server是一个基于AI的多代理自主工程生态系统，提供代码调试、审查、测试、部署和安全保障等功能，适用于软件开发全生命周期管理。

  • by Edge-Explorer
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Edge-Explorer/DevGuardian

使用说明

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

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

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个工具）

自主代理

工具 说明
agent_swarm 具有对抗反馈循环和沙盒执行的3代理管道（程序员、测试员、审阅者）。循环直到代码被接受。
autonomous_engineer 有状态的LangGraph代理，负责规划、循环执行工具、验证工作和自我纠正。

AI代码智能

工具 说明
debug_error 分析错误和堆栈痕迹；返回具有完整项目上下文的根本原因和确切修复。
explain_code 理解任何代码用简单的英语做什么。
review_code 项目意识代码审查，涵盖错误、安全性、性能和风格。
generate_code 生成适合项目架构的干净代码。
improve_code 始终如一地重构和改进现有代码。

质量和测试

工具 说明
test_and_fix TDD Auto Pilot：生成pytest测试，运行它们，修复源代码，直到测试通过
review_pull_request 从GitHub获取PR差异并执行AI驱动的代码审查。

DevOps和基础设施

工具 说明
dockerize 自动生成 Dockerfile 和 docker-compose.yml 根据您的堆叠量身打造。
generate_ci 自动生成 .github/workflows/ci.yml 包括linting、测试、Docker和自我修复工作。
generate_gitignore 分析您的项目结构并生成量身定制的 .gitignore在加入之前征求许可 .env 模式。

架构和文档

工具 说明
generate_architecture_map 分析内部导入并生成项目的Mermaid.js依赖关系图。
generate_technical_docs 使用Gemini生成高密度技术架构摘要。

大规模运营

工具 说明
mass_refactor 在项目中的每个Python文件上同时应用一条指令。

安全

工具 说明
validate_env 验证 .env 文件格式安全——从不公开秘密值。
security_scan 扫描仓库中是否有20多种凭证类型和缺失 .gitignore 新闻报道。

Git套件

工具 说明
smart_commit AI读取你的差异，写一条提交消息，扫描凭证泄漏，然后提交。
git_status 显示工作树状态。
git_add 提交阶段文件。
git_commit 使用自定义消息提交。
git_push 按遥控器（受安全门保护）。
git_pull 从远程拉。
git_log 查看提交历史记录。
git_diff 显示阶段性或非阶段性差异。
git_branch 列出所有分支。
git_checkout 切换或创建分支。
git_stash 停滞或不稳定的变化。
git_reset 重置HEAD（软、混合、硬）。
git_remote 列出已配置的遥控器。

设置

先决条件

安装

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构建。

相关 MCP