Git工作树管理服务

一个管理AI编码代理隔离Git工作树的MCP服务器,支持创建、删除和列出会话,并持久化会话数据到SQLite数据库。

  • by tzDel
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 tzDel/agent-manager-mcp

使用说明

管弦乐队指挥

一个MCP(模型上下文协议)服务器,为AI编码代理管理隔离的git工作树。

它做什么

  • 创建 .worktrees/session-<id> 目录+ session-<id> 按需分支(基础分支是 main).
  • 将会话数据持久化到SQLite数据库中(.orchestragent-mcp.db 默认情况下)。这确保了会话信息在服务器重启后仍然有效。
  • 列出活动会话,包括工作树路径和与基本分支的差异统计信息。
  • 删除对未提交文件和未发布提交进行安全检查的会话(用覆盖 force=true).
  • 通过stdio与MCP对话,因此您可以在任何兼容MCP的客户端上注册它。

建筑

看 docs/architecture.md 获取详细的架构文档。

MCP工具

  • 创建工作树:为代理创建隔离的git工作树和分支

    Example: "Create a worktree for session abc123"
    
  • 删除会话:拆下代理工作台和分支

    Example: "Remove all sessions" || "Remove session abc123"
    
  • 列出会话:检索状态、工作树路径和分支信息

    Example: "List all sessions" || "List session abc123"
    

使用MCP客户端进行配置

克劳德代码CLI

claude mcp add --transport stdio orchestragent-mcp -- "<path-to-binary>" -repo <path-to-repo>
claude mcp list

Codex CLI

codex mcp add orchestragent-mcp -- "<path-to-binary>" -repo <path-to-repo>
codex mcp list

运行时标志

  • -repo:git存储库的路径(默认为当前工作目录)。
  • -db:创建SQLite数据库的目录。默认为当前工作目录;数据库文件始终命名为 .orchestragent-mcp.db。从当前工作目录解析相对路径。

项目状态

目前正在开发中。看 docs/concept.md 愿景和路线图。