backlog-mcp

MCP-сервер, который предоставляет AI-агентам структурированный доступ на чтение/запись к бэклогу проекта, основанному на историях. Агенты могут просматривать список историй, читать их содержимое, обновлять статус и добавлять заметки — всё это хранится в обычных markdown-файлах внутри вашего репозитория проекта.

Как работает совместная работа

Здесь нет общего сервера. Файлы бэклога находятся в вашем репозитории в папке requirements/, они коммитятся и версионируются вместе с вашим кодом. Совместная работа между агентами или между агентом и человеком происходит точно так же, как и с остальной частью вашей кодовой базы: через git. Если два агента одновременно обновляют разные истории, git объединяет их изменения. Если они затрагивают одну и ту же строку, вы разрешаете конфликт так же, как и любой другой конфликт слияния.

MCP-сервер — это локальный процесс, который каждый агент запускает для себя. Он читает и записывает файлы; git берет на себя всё остальное.

Установка

Скачайте последний бинарный файл для вашей платформы со страницы Releases и поместите его куда-нибудь в ваш $PATH.

Или, если у вас установлен Go:

go install github.com/corbym/backlog-mcp@latest

Сборка из исходного кода

go mod tidy
go build -o backlog-mcp .

Настройка

Инициализируйте папку requirements/ в корне вашего проекта:

./backlog-mcp init /path/to/your/project/requirements

Это создаст:

requirements/
  requirements-index.md   # master index — source of truth for epics and story status
  backlog.md              # priority-ordered list of not-done stories
  epic-001-example/
    story-001.md          # example story file

Закоммитьте папку requirements/ в ваш репозиторий. Редактируйте файлы, чтобы добавить свои собственные эпики и истории.

Запуск

./backlog-mcp

Сервер ищет директорию requirements/ относительно рабочей директории, из которой он был запущен. Claude Code устанавливает рабочую директорию в корень проекта, поэтому настройка не требуется.

Конфигурация Claude Code (.claude/settings.json в вашем проекте или ~/.claude/settings.json глобально):

{
  "mcpServers": {
    "backlog-mcp": {
      "command": "/path/to/backlog-mcp"
    }
  }
}

Инструменты

Переменные окружения

Формат файлов

requirements-index.md — один раздел эпика на заголовок, одна история на строку таблицы:

## EPIC-001: Combat System — `draft`

| Story | Title | Status |
|-------|-------|--------|
| [STORY-001](./epic-001-combat-system/story-001.md) | Basic combat | draft |

backlog.md — нумерованный список, упорядоченный по приоритету:

1. **STORY-001** — Basic combat
2. **STORY-002** — Enemy AI *(in-progress)*

Файлы историй находятся по адресу epic-NNN-slug/story-NNN.md внутри BACKLOG_ROOT.

Значения статусов: draft, in-progress, done, blocked

Примечания

• Запись файлов атомарна (временный файл + переименование) — сбой во время записи не может повредить ваши файлы.

• Файловая система является источником истины. MCP-сервер никогда не владеет данными.