Mooring — Git & GitHub MCP 服务器

License: MIT

为你的代码提供系泊缆绳 — 专为 AI 工具设计的 Git 和 GitHub 操作。

Mooring 是一个 MCP 服务器，为 AI 助手提供对本地 Git 仓库和 GitHub API 的结构化访问。本地操作使用 GitPython（无子进程调用）。GitHub 操作使用 PyGithub 库，并内置了令牌屏蔽和速率限制处理。

工具

本地 Git

工具	描述	关键参数
`repo_status`	分支、领先/落后情况、暂存数量、已暂存/未暂存/未追踪文件	`repo_path`
`repo_log`	带有可选过滤器的提交日志	`repo_path`, `max_count`, `author`, `since`, `path`, `search`
`repo_diff`	统一差异 — 工作树、已暂存或引用之间的差异	`repo_path`, `staged`, `from_ref`, `to_ref`
`repo_blame`	带有可选行范围的 Git blame	`repo_path`, `file_path`, `start_line`, `end_line`
`repo_branches`	带有追踪信息、最后一次提交、领先/落后情况的所有分支	`repo_path`
`repo_stash`	暂存操作：列表、推送、弹出、应用	`repo_path`, `action`, `message`

GitHub

工具	描述	关键参数
`gh_pr_list`	列出拉取请求	`repo`, `state`, `author`, `label`
`gh_pr_detail`	包含审查、评论和检查运行的 PR 详情	`repo`, `number`
`gh_pr_create`	创建拉取请求	`repo`, `title`, `body`, `head`, `base`, `labels`, `reviewers`
`gh_issues`	列出、创建或更新 Issue	`repo`, `state`, `action`, `title`, `body`, `number`
`gh_actions`	列出最近的 GitHub Actions 工作流运行	`repo`, `workflow`, `status`

实用工具

工具	描述	关键参数
`health`	服务器版本和状态检查	(无)

安装

# PyPI
pip install mooring-mcp

# Isolated install
pipx install mooring-mcp

使用方法

直接运行服务器：

mooring

Claude Code

claude mcp add mooring -- mooring

Claude Desktop

添加到你的 Claude Desktop 配置文件 (claude_desktop_config.json) 中：

{
  "mcpServers": {
    "mooring": {
      "command": "mooring",
      "env": {
        "GITHUB_TOKEN": "your-github-personal-access-token"
      }
    }
  }
}

所有 GitHub 工具 (gh_*) 都需要 GITHUB_TOKEN 环境变量。本地 Git 工具无需此变量即可工作。

安全性

路径遍历保护 — 在进行任何操作之前，文件路径都会被解析并根据仓库根目录进行验证
符号链接逃逸检测 — 解析到仓库外部的符号链接将被拒绝
引用验证 — Git 引用会在使用前根据安全字符模式进行检查并验证其是否存在
令牌屏蔽 — 错误消息在返回前会清除 GitHub 令牌模式 (ghp_*, gho_*, github_pat_*)
速率限制处理 — GitHub 403 响应会被捕获并作为清晰的消息呈现，而不是原始异常

开发

git clone https://github.com/seayniclabs/mooring.git
cd mooring
python -m venv .venv && source .venv/bin/activate
pip install -e ".[test]"
python -m pytest tests/ -q