Engineering MCP

Lokaler MCP für Engineering: Tickets, QA-Nachweise und Zeit kommen rein; Untersuchung schließt Ursache ab; Wissen bleibt; Reporting kommt fertig raus.

Ersetzt nicht, was du bereits hast:

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

Problem, das es löst

Ein Ticket in Jira, ein Fehlschlag im CI und eine Zeiterfassung leben an drei Orten. Zur Statusabfrage baut niemand das Paket zusammen.

Dieser MCP zeichnet den Zyklus in derselben lokalen Datenbank auf:

1. Öffnet das Ticket (WORK)

2. Hängt den Fehlschlag / Bug / Screenshot an (QA) — ohne die Suite auszuführen

3. Erfasst Stunden und Schätzung (TIME)

4. Untersucht bis zur Ursache (INVESTIGATION)

5. Wird zum Playbook (KNOWLEDGE)

6. report_ticket liefert das Paket für Handoff, Daily oder Karrierenachweis.

Related MCP server: Productivity Tracker MCP Server

Anforderungen

• Node 22+ (natives node:sqlite, wie beim qa-oracle)

• MCP-Client (Cursor)

Installation (ohne absoluten Pfad)

Cursor zeigt nicht auf den Ordner auf dem Desktop. Er lädt das Paket herunter — wie beim qa-lab-agent. Die Datenbank liegt in ~/.engineering-mcp/engineering.db, auf jedem Rechner.

Konfiguration in Cursor (~/.cursor/mcp.json)

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

Keine args mit /Users/.... Kein ENGINEERING_MCP_DB. Lade die MCPs neu.

Das funktioniert, sobald das Paket auf npm oder auf GitHub ist (unten). Bis zur Veröffentlichung verwende die lokale Verknüpfung (ebenfalls ohne Pfad in mcp.json):

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

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

npm install -g . setzt den Befehl in den PATH. Die mcp.json nennt nur den Namen.

Wo hosten (npm vs. GitHub vs. Cloud)

Keine eigene Website nötig. Die „Website“ ist npmjs.com — dieselbe wie beim mcp-lab-agent. Cursor führt den MCP auf deiner Maschine aus; die Cloud liefert nur den Code.

Eine URL-Cloud ("url": "https://...") gibt es in Cursor, aber dann ist SQLite nicht mehr lokal: Tickets, Bugs und Stunden würden auf einem Server leben. Das ist ein Multi-User-Produkt, nicht diese v0.

Auf npm veröffentlichen (wie der lab-agent)

Der Name engineering-mcp ist frei. Mit bereits angemeldetem npm-Konto:

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

Danach verwendet jeder Mac nur den obigen npx-Block.

Auf GitHub veröffentlichen (ohne 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

Alternative Konfiguration, weiterhin ohne Pfad:

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

Starte Cursor neu (oder lade die MCPs neu). Die Datenbank wird automatisch in ~/.engineering-mcp/ erstellt.

Typischer Ablauf

"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

Wenn du das Tool nicht kennst: eng_route mit dem Satz auf Portugiesisch.

Werkzeuge

WORK

Status: backlog · todo · doing · review · done
Priorität: p0 … p3
external_key speichert den Jira/GitLab-Schlüssel, ohne noch eine API abzurufen.

QA

Das Ausführen von Tests bleibt beim qa-lab-agent. Der Unternehmens-Jira-Verlauf bleibt beim qa-oracle.

TIME

INVESTIGATION

Klassifizierung: bug · flaky · infra · regression · unknown

KNOWLEDGE

REPORTING

Struktur

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

Standard-Datenbank: ~/.engineering-mcp/engineering.db (reist nicht mit dem Repo).

Nichts verlässt die Maschine außer dem, was der Agent bereits im Chat sieht. Kein Jira/GitLab in v0 — external_key ist der Haken für die spätere Synchronisierung.

v0 vs. später

Jetzt: lokale Datenbank, geschlossener Zyklus, Cursor.

Später (nur wenn v0 verwendet wird):

• Jira → Tickets synchronisieren (Client des qa-oracle wiederverwenden)

• Run vom qa-lab-agent / Job von GitLab importieren

• HTML-Dashboard des report_status

Sicherheit

• Datenbank in ~/.engineering-mcp/ (außerhalb des Repos)

• Keine Tokens in v0

• Veröffentlichung auf npm/GitHub sendet Code, keine Tickets