Vexorbis Swarm MCP

⚠️ 已弃用： 该项目已完全迁移至hermes代理。

Vexorbis Swarm v3.4

将您的IDE变成一个自主的工程团队

 ](https://docker.com)  

______________________________________________________________________

Swarm是什么？

群集 是一个模型上下文协议（MCP）服务器，它扩展了人工智能编码助手，如Antigravity、Cursor和Claude Desktop 确定性、算法能力Swarm不完全依赖LLM推理，而是使用专门的workers代码分析、故障定位、形式验证和自主Git管理来提供更快、更可靠的结果。

______________________________________________________________________

✨ 三大支柱

🧠 算法核心

超越文本搜索。

• HippoRAG：基于AST的知识图，带有个性化PageRank，用于深入理解代码。
• 奥恰伊SBFL：通过统计而不是猜测来发现bug。
• Z3验证器：关键逻辑的正式验证。

🤖 自主劳动力

让代理人来处理繁重的工作。

• Git代理角色：计划、提交和创建PR的专业人员（建筑师、工程师、审计员）。
• 动态工具匠Swarm可以在运行时设计和注册新工具。
• Markdown驱动：从一个角度控制劳动力 PLAN.md 文件。

🛡️ 积极治理

保持控制。

• 遥测存储器：SQLite支持的持久性用于会话上下文和故障分析。
• 自愈：检测重复故障并提醒代理更改策略。
• 许可优先：自主操作（如工具创建）需要用户批准。

______________________________________________________________________

🚀 快速开始

Docker（推荐）

git clone https://github.com/projectvgony/Vexorbis.git
cd Vexorbis
cp .env.example .env   # Add your GEMINI_API_KEY (and optionally GITHUB_TOKEN)
docker compose up -d --build

配置IDE

将MCP服务器添加到IDE的配置中（例如。， ~/.antigravity/settings.json):

{
  "mcpServers": {
    "swarm-orchestrator": {
      "command": "docker",
      "args": ["exec", "-i", "swarm-mcp-server", "fastmcp", "run", "server.py"]
    }
  }
}

______________________________________________________________________

🔍 工具选择指南

flowchart LR
    Start([My Goal]) --> Q1{Type?}

    Q1 -->|Find symbol by name| A["search_codebase(keyword_only=true)
~1ms"]
    Q1 -->|Find code by concept| B["search_codebase()
~240ms"]
    Q1 -->|Understand architecture| C["retrieve_context()
~1-2s"]
    Q1 -->|Debug failing tests| D["debug command
Ochiai SBFL"]

    style A fill:#2ecc71,color:#fff
    style B fill:#3498db,color:#fff
    style C fill:#9b59b6,color:#fff
    style D fill:#e74c3c,color:#fff

______________________________________________________________________

🔄 反重力同步

Swarm与人类可读的同步 PLAN.md 文件，实现真正的副驾驶工作流程。

从你的Markdown：

## Todo
- [ ] Refactor auth module @architect
  - Context: auth.py
- [ ] Add login tests @engineer

Swarm解释：

• [ ] → 任务是 PENDING特工把它捡起来了。
• @architect → 分配给建筑师工人。
• Context: → 预加载 auth.py 进入代理人的窗口。

完成后：

• 代理标记任务 [x] 在你的 PLAN.md 自动。

______________________________________________________________________

📖 文档

______________________________________________________________________

📊 实施状态

______________________________________________________________________

🤝 贡献

我们欢迎捐款！看 贡献.md.

开发模式：

# Enable debug features
export SWARM_DEBUG=true
export SWARM_VERBOSE_TELEMETRY=true

______________________________________________________________________

📜 许可证

MIT许可证-请参阅 许可证 了解详情。