Mooring — MCP-сервер для Git и GitHub

License: MIT

Швартовы для вашего кода — операции с Git и GitHub для ИИ-инструментов.

Mooring — это MCP-сервер, который предоставляет ИИ-ассистентам структурированный доступ к локальным Git-репозиториям и API GitHub. Локальные операции используют GitPython (без вызовов subprocess). Операции с GitHub используют библиотеку PyGithub со встроенной маскировкой токенов и обработкой ограничений частоты запросов (rate limits).

Инструменты

Локальный Git

Инструмент	Описание	Ключевые параметры
`repo_status`	Ветка, опережение/отставание, количество stash, индексированные/неиндексированные/неотслеживаемые файлы	`repo_path`
`repo_log`	Журнал коммитов с опциональными фильтрами	`repo_path`, `max_count`, `author`, `since`, `path`, `search`
`repo_diff`	Unified 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`	Операции со stash: список, push, pop, apply	`repo_path`, `action`, `message`

GitHub

Инструмент	Описание	Ключевые параметры
`gh_pr_list`	Список pull request'ов	`repo`, `state`, `author`, `label`
`gh_pr_detail`	Детали PR с ревью, комментариями и результатами проверок	`repo`, `number`
`gh_pr_create`	Создание pull request'а	`repo`, `title`, `body`, `head`, `base`, `labels`, `reviewers`
`gh_issues`	Список, создание или обновление issues	`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_TOKEN обязательна для всех инструментов GitHub (gh_*). Локальные инструменты Git работают без неё.

Безопасность

Защита от обхода путей (path traversal) — пути к файлам разрешаются и проверяются относительно корня репозитория перед любой операцией
Обнаружение выхода за пределы через симлинки — симлинки, указывающие за пределы репозитория, отклоняются
Проверка ссылок (ref validation) — 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

Лицензия

MIT

Mooring