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

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

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

Инструменты

Локальный Git

GitHub

Утилиты

Related MCP server: Git MCP Server

Установка

# 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