personal-repo-mcp

Самостоятельно размещаемый MCP-сервер с поддержкой нескольких репозиториев для ИИ-агентов. Он предоставляет агенту постоянное Git-рабочее пространство на вашем собственном VPS, с контролируемым доступом на чтение/запись к репозиториям, одобренным администратором, и стандартными операциями Git.

Версия 1.0.0 — MVP

Основная идея

Администратор управляет тем, к каким репозиториям агент может получить доступ. Агент управляет тем, какие из разрешённых репозиториев он фактически клонирует.

Administrator
    |
    | mcp-config add repo jsilvanus/*
    v
repositories.json (allow-list)
    |
    v
MCP server
    |
    +-- clone_repository("jsilvanus/project")
    |
    v
persistent workspace

Related MCP server: GitLab MR MCP

Справочные материалы MCP

Сервер предоставляет модульную, нативную для MCP эксплуатационную документацию. Начните с:

mcp://help/index

Доступны тематические разделы:

mcp://help/repositories
mcp://help/files
mcp://help/git
mcp://help/chain-command
mcp://help/resources

Справочные материалы намеренно отделены от tools/list: список инструментов MCP остаётся авторитетной поверхностью API, а справочные материалы обеспечивают руководство по рабочим процессам с постепенным раскрытием информации для агентов.

Возможности

• Постоянные рабочие пространства для нескольких репозиториев

• Список разрешённых репозиториев, контролируемый администратором

• Аутентификация GitHub PAT для операций Git

• Потоковый HTTP-транспорт

• Чтение файлов, чтение диапазонов строк, запись, правки строк, поиск и патчи

• Git: статус, diff, история, ветки, fetch/pull/push, merge/rebase и обработка конфликтов

• chain_command для одного репозитория — составление операций

• Ресурсы MCP для состояния системы, репозитория, Git и отдельных файлов

• Подписки на ресурсы и уведомления об изменениях

• Очистка секретов из вывода MCP

• Защитные механизмы для подмодулей Git

• Развёртывание через Docker

Развёртывание

Настройте хост с помощью mcp-config, затем запустите единый контейнер Docker:

mcp-config pat
mcp-config add repo jsilvanus/*
docker compose up -d --build

mcp-config add repo изменяет только список разрешённых администратором репозиториев. Он не клонирует репозитории. Агент клонирует разрешённый репозиторий через MCP, когда это необходимо.

См. документацию по развёртыванию в docs/ для получения сведений о постоянном хранилище, учётных данных, HTTPS и настройке.

Лицензия

EUPL-1.2