Engineering MCP

エンジニアリング用のローカルMCP：チケット、QAエビデンス、工数が入り、調査が根本原因を確定し、ナレッジが蓄積され、レポートが完成して出力されます。

既存のツールを置き換えるものではありません：

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

解決する課題

Jiraのチケット、CIの失敗、工数の記録は3つの場所に分散しています。ステータス報告の時点で、誰もパッケージをまとめられません。

このMCPはサイクルを同じローカルDBに記録します：

1. チケットを開く（WORK）

2. fail / bug / スクリーンショットを添付（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はDesktopのフォルダを参照しません。パッケージをダウンロードします — qa-lab-agentと同じです。DBはどのマシンでも ~/.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をリロード）。DBは ~/.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

標準DB：~/.engineering-mcp/engineering.db（リポジトリと一緒に移動しません）。

エージェントがチャットで既に見ているもの以外は、マシンから外部に出ません。v0ではJira/GitLabなし — external_key は将来の同期用フックです。

v0 vs 今後

現在： ローカルDB、クローズドサイクル、Cursor。

今後（v0が使用された場合のみ）：

• Jira → チケットの同期（qa-oracleのクライアントを再利用）

• qa-lab-agentのrun / GitLabのjobをインポート

• report_status のHTMLダッシュボード

セキュリティ

• DBは ~/.engineering-mcp/ に配置（リポジトリ外）

• v0ではトークンなし

• npm/GitHubへの公開はコードのみ送信、チケットは送信しない