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"]
    }
  }
}

/Users/...가 포함된 args 없음. 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는 아직 API를 호출하지 않고 Jira/GitLab 키를 저장합니다.

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 (리포지토리와 함께 이동하지 않음).

에이전트가 채팅에서 이미 보는 것 외에는 아무것도 머신 밖으로 나가지 않습니다. v0에는 Jira/GitLab 없음 — external_key는 나중에 동기화를 위한 연결 고리입니다.

v0 vs 이후

지금: 로컬 데이터베이스, 닫힌 주기, Cursor.

이후 (v0이 사용된 경우에만):

• Jira → 티켓 동기화 (qa-oracle 클라이언트 재사용)

• qa-lab-agent / GitLab 작업에서 실행 가져오기

• report_status의 HTML 대시보드

보안

• 데이터베이스는 ~/.engineering-mcp/ (리포지토리 외부)

• v0에는 토큰 없음

• npm/GitHub에 게시하면 코드만 전송, 티켓 아님