Engineering MCP

MCP локальный для инженерии: тикеты, доказательства QA и время входят; расследование закрывает первопричину; знания остаются; отчёт выходит готовым.

Не заменяет то, что у вас уже есть:

ENGINEERING MCP
      │
      ├── WORK        tickets · tasks · projects
      ├── QA          testing evidence · bugs · artifacts
      └── TIME        tracking · estimates · metrics
              │
              ▼
        INVESTIGATION
              │
              ▼
          KNOWLEDGE
              │
              ▼
          REPORTING

Какую проблему решает

Тикет в Jira, фейл в CI и запись времени живут в трёх местах. В момент статуса никто не собирает пакет.

Этот MCP записывает цикл в ту же локальную базу:

1. Открывает тикет (WORK)

2. Прикрепляет фейл / баг / скриншот (QA) — без запуска набора тестов

3. Фиксирует часы и оценку (TIME)

4. Расследует до первопричины (INVESTIGATION)

5. Превращает в плейбук (KNOWLEDGE)

6. report_ticket возвращает пакет для передачи, дейли или доказательства карьерного роста

Related MCP server: Productivity Tracker MCP Server

Требования

• Node 22+ (нативный node:sqlite, как в qa-oracle)

• MCP-клиент (Cursor)

Установка (без абсолютного пути)

Cursor не указывает на папку на рабочем столе. Он скачивает пакет — как qa-lab-agent. База находится в ~/.engineering-mcp/engineering.db на любой машине.

Конфигурация в Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "engineering": {
      "command": "npx",
      "args": ["-y", "engineering-mcp"]
    }
  }
}

Без args с /Users/.... Без ENGINEERING_MCP_DB. Перезагрузите MCP.

Это работает после того, как пакет окажется в npm или на GitHub (ниже). До публикации используйте локальный ярлык (также без пути в mcp.json):

cd ~/Desktop/engineering-mcp
npm install
npm install -g .

{
  "mcpServers": {
    "engineering": {
      "command": "engineering-mcp"
    }
  }
}

npm install -g . помещает команду в PATH. В mcp.json указывается только имя.

Где разместить (npm vs GitHub vs облако)

Не нужен собственный сайт. «Сайт» — это npmjs.com — тот же, что у mcp-lab-agent. Cursor запускает MCP на вашей машине; облако только доставляет код.

Облако типа URL ("url": "https://...") существует в Cursor, но тогда SQLite перестаёт быть локальным: тикеты, баги и часы будут жить на сервере. Это многопользовательский продукт, а не эта v0.

Публикация в npm (как lab-agent)

Имя engineering-mcp свободно. С уже залогиненной npm-учёткой:

cd ~/Desktop/engineering-mcp
npm test
npm publish --access public

После этого любой Mac использует только блок npx выше.

Публикация на GitHub (без npm)

cd ~/Desktop/engineering-mcp
git init
git add .
git commit -m "feat: engineering mcp v0.1"
gh repo create Wesley-Gomes93/engineering-mcp --public --source . --remote origin --push

Альтернативная конфигурация, всё ещё без пути:

{
  "mcpServers": {
    "engineering": {
      "command": "npx",
      "args": ["-y", "github:Wesley-Gomes93/engineering-mcp"]
    }
  }
}

Перезапустите Cursor (или перезагрузите MCP). База создаётся сама в ~/.engineering-mcp/.

Типичный цикл

"Abre um projeto Atlas (ATL) e um bug P1: timeout no checkout"
  → work_upsert_project + work_upsert_ticket

"Registra o fail do checkout.spec.js e anexa o log"
  → qa_record_run + qa_attach_evidence

"Estima 4h e lança 1.5h de repro"
  → time_estimate + time_log

"Abre investigação: hipótese de seletor instável"
  → investigate_open + investigate_add_finding

"Fecha como flaky: timing no botão Finalizar"
  → investigate_conclude

"Vira playbook: wait da animação + data-testid"
  → knowledge_save

"Me dá o pacote do ticket"
  → report_ticket

Если не знаете инструмент: eng_route с фразой на португальском.

Инструменты

WORK

Статусы: backlog · todo · doing · review · done
Приоритет: p0 … p3
external_key хранит ключ Jira/GitLab, пока без обращения к API.

QA

Выполнение тестов остаётся в qa-lab-agent. Корпоративная история Jira остаётся в qa-oracle.

TIME

INVESTIGATION

Классификация: bug · flaky · infra · regression · unknown

KNOWLEDGE

REPORTING

Структура

engineering-mcp/
├── src/
│   ├── server.js              # MCP stdio
│   ├── lib/store.js           # SQLite — fonte da verdade
│   └── domains/
│       ├── work.js
│       ├── qa.js
│       ├── time.js
│       ├── investigation.js
│       ├── knowledge.js
│       └── reporting.js
└── test/store.test.js

База по умолчанию: ~/.engineering-mcp/engineering.db (не путешествует с репозиторием).

Ничего не покидает машину, кроме того, что агент уже видит в чате. Без Jira/GitLab в v0 — external_key — это зацепка для синхронизации позже.

v0 vs потом

Сейчас: локальная база, замкнутый цикл, Cursor.

Потом (только если v0 используется):

• Синхронизация Jira → тикеты (переиспользовать клиент qa-oracle)

• Импорт прогона из qa-lab-agent / job из GitLab

• HTML-дашборд из report_status

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

• База в ~/.engineering-mcp/ (вне репозитория)

• Без токенов в v0

• Публикация в npm/GitHub отправляет код, а не тикеты