Performance Review MCP

Go stdio MCP-сервер, который собирает данные для performance review из локальных источников (git-коммиты GitLab-клона, Jira через отдельный MCP, markdown с задачами) и раскладывает их по секциям шаблона Kode Self-Reflection.

• 4 tool-а под секции Excel: fill_self_reflection, review_previous_ipr, propose_next_ipr, find_completed_work.
• Подключение к Codex / Claude Code / Cursor — одной строкой.

Данные из Jira подтягиваются отдельным готовым MCP-инструментом для Jira — этот сервер с Jira не работает.

1. Установка

Go ставить не нужно — npm и Homebrew качают готовый бинарь из GitHub Releases. Любой вариант:

# npm (только Node 18+, без Go)
npm install -g performance-review-mcp

# Homebrew (без Go)
brew tap batrusha262-debug/tap
brew install performance-review-mcp

# Прямо из GitHub Releases (без Node, без Go) — скачай tar.gz под свою ОС:
#   https://github.com/batrusha262-debug/mcp_pr/releases/latest
# и положи бинарь в $PATH.

Для разработчиков сервера (нужен Go 1.22+):

go install github.com/batrusha262-debug/mcp_pr/cmd/performance-review-mcp@latest
# или локально из исходников:
make build   # бинарь в dist/performance-review-mcp

Проверка:

performance-review-mcp --version

2. Подключение к Codex / Claude / Cursor

MCP запускается обычным бинарём — никаких wrapper-скриптов и токенов.

# Codex
codex mcp add performance-review -- performance-review-mcp

# Claude Code
claude mcp add performance-review -- performance-review-mcp

# Cursor / любой клиент с mcp.json
# В mcp.json:
#   "performance-review": { "command": "performance-review-mcp" }

Перезапусти клиент. В списке инструментов появятся 4 tool-а.

3. Tools под Excel «Self-Reflection»

| Tool | Что заполняет в шаблоне | |------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------| | fill_self_reflection | 3 колонки за период: «Что получилось хорошо» (формат «что было — что делали — как стало»), «Выдающийся результат», «Что не было сделано / плохо». Плюс evidence-ссылки. | | review_previous_ipr | Таблица «ИПР предыдущего периода». На вход список целей предыдущего периода — на выход статус (Да / В процессе / Не достигнута) + evidence. | | propose_next_ipr | Таблица «ИПР на следующий период». Берёт focus_areas и набрасывает строки срок / действие / показатель / для чего. Пользователь дорабатывает. | | find_completed_work | Сырой список git-коммитов / Jira-задач (из jira_issues) / отмеченных задач из markdown. Для случаев, когда хочется собрать факты руками. |

Tool-ы принимают одинаковый набор аргументов (период, repo_path, tasks_path, focus_areas, …). Для review_previous_ipr добавляется previous_goals: []string.

Данные кода берутся из git-коммитов локального клона (GitLab). Задачи Jira этот сервер сам не тянет — их подтягивает отдельный Jira-MCP, а клиент передаёт готовый список в аргументе jira_issues:

"jira_issues": [
  { "key": "WELL-123", "title": "Экспорт отчётов", "url": "https://jira/browse/WELL-123", "resolved_at": "2026-05-10", "status": "Done", "type": "Story" }
]

MCP мёржит их в общую ленту завершённой работы наравне с коммитами.

4. Примеры запросов в Codex / Claude

Tool вызывать руками не нужно — пиши обычным текстом, клиент сам подберёт инструмент.

Заполнить Self-Reflection за полугодие

Заполни Self-Reflection для performance review за период 2026-04-01..2026-11-01.
Репозитории: /Users/adt/kode/well-be. Бери git-коммиты.
Задачи из Jira подтяни через Jira-MCP и передай в jira_issues.
focus_areas: backend, quality, delivery, growth.
Положи результат в 3 колонки по шаблону.

Оценить ИПР предыдущего периода

В Excel у меня было три ИПР (см. файл):

Проверь по фактам выполнение моих ИПР предыдущего периода:
  1) Улучшение качества проверок в CI
  2) Оптимизация CI pipeline
  3) Оптимизация Docker-образов проекта
Данные бери из /Users/adt/kode/well-be (коммиты, PR) за 2025-12-01..2026-05-30.
Для каждой цели верни статус и evidence.

Спланировать ИПР на следующий период

Предложи 3-4 пункта ИПР на следующее полугодие.
role: backend developer middle.
focus_areas: транзакционность и параллелизм, шаринг знаний на отдел, использование ИИ в процессах.
Период следующего PR: до 2026-11-01.
Заполни срок / действие / показатель / для чего.

Найти только факты, без интерпретации

Найди мою завершённую работу за май 2026 в /Users/adt/kode/well-be.
Покажи отдельно git-коммиты и Jira-задачи. Не группируй.

5. Формат tasks-файла (для аналитиков / QA / менеджеров)

Если часть работы не видна в git, заведи markdown-файл и передай через tasks_path:

- [x] 2026-05-03 Согласовал edge-cases для отмены записи
- [x] 2026-05-11 Нашёл critical bug в payment flow до релиза
- [x] 2026-05-18 Подготовил метрики для конверсии partner onboarding
- [ ] 2026-05-20 Эта строчка в review не попадёт — не завершена

MCP фильтрует по дате и берёт только [x].

6. CLI-справочник

performance-review-mcp                 запустить MCP-сервер на stdio
performance-review-mcp --version
performance-review-mcp --help

7. Что проверить руками перед отправкой review

• В черновике не осталось внутренних / чувствительных деталей.
• Impact, а не список действий — для каждого пункта есть «зачем».
• Evidence (PR, релизы, метрики) присутствует у каждого блока.
• Нет чужих достижений, случайно записанных на тебя.
• ИПР на следующий период — измеримые показатели, не «улучшить X».

8. Разработка

make check    # gofmt + go vet + go test ./...
make build    # бинарь в dist/
go test ./...

Release:

git tag v0.3.0
git push origin v0.3.0

GitHub Actions соберёт релиз через GoReleaser и обновит Homebrew tap.