Worktree Orbit Mcp

io.github.mrfentmen由 GitHub 账号 mrfentmen 发布v1.0.0更新于 Oct 30, 2026

Aggregate local Git worktree topology without exposing repository content. Tools include inspect...

已验证STDIO仅桌面文件与存储开发者工具

概览

AI 生成的概览

本地 MCP 服务器,以聚合方式报告仓库的 Git worktree 拓扑,如数量、干净或脏状态、锁定与可清理标记,不暴露仓库内容。

可以做什么
  • 检查仓库的 worktree 拓扑:worktree 总数、主工作树与关联工作树数量、干净或脏的数量、分离、锁定与可清理状态,以及粗略的拓扑提示。
  • 只返回聚合信号,不返回路径、分支名、哈希、远程地址、锁定原因、提交主题、作者或文件内容。
适用场景
适合同时维护多个 Git worktree 的开发者,让助手判断某个仓库是否存在并行 worktree、它们是否干净,以及是否有分离、锁定或可清理的 worktree 需要处理。
运行要求
以 stdio 方式在本机运行的本地进程,从 npm 包安装,构建后用 Node.js 启动。所选仓库必须位于 WORKTREE_ORBIT_ROOT 环境变量指定的目录内。仅使用本地 Git 命令,不访问网络。
安装前请注意
设计为只读:不会新增、删除、移动、锁定、解锁、重置、清理或修改 worktree。结果是聚合信号,不能替代在删除某个 worktree 前对其单独检查。状态检查有范围与时间限制。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Worktree Orbit Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

worktree-orbit-mcp

Worktree Orbit is a local MCP for developers who keep several Git worktrees alive at once. It answers whether a repository has parallel worktrees, whether they are clean, and whether detached, locked, or prunable worktrees need attention.

Tool

  • inspect_worktree_topology: returns aggregate worktree count, primary and linked counts, clean or dirty counts, detached state, lock state, prunable state, and a coarse topology hint.

It never returns paths, branch names, hashes, remotes, lock reasons, subjects, authors, or file contents.

Safety

  • Local Git commands only. No network access is used.
  • The selected repository must stay inside WORKTREE_ORBIT_ROOT.
  • Commands are read-only: the server does not add, remove, move, lock, unlock, reset, prune, or modify worktrees.
  • Worktree status checks are bounded and time limited.
  • Results are aggregate signals, not a replacement for inspecting a specific worktree before deleting it.

Run

bash
npm installnpm run buildnode dist/index.js

来源:README.md,提交 7330cc2

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 22, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。