Tpm MCP

🚀 tpm-mcp

tpm-mcpは、AIを搭載した技術的なプロジェクトマネージャーです。Claudeとのスタンドアップミーティングを行い、機能を追跡し、タスクを分解し、より迅速に製品をリリースすることができます。

🚀 クイックスタート

tpm-mcpは、Claudeにプロジェクト、機能、タスクを追跡する機能を付与するローカルのMCP（Model Context Protocol）サーバーです。セッションをまたいで作業内容を記憶し、複雑な機能を管理可能なタスクに分解し、進捗とブロッカーを追跡し、即座にステータスを更新します。

✨ 主な機能

📦 インストール

1. クローンとインストール

git clone https://github.com/yourusername/tpm-mcp.git
cd tpm-mcp
uv venv && uv pip install -e .

2. Claudeコードに追加

claude mcp add tpm --scope user -- uv run --directory /path/to/tpm-mcp tpm-mcp

{
  "mcpServers": {
    "tpm": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/tpm-mcp", "tpm-mcp"]
    }
  }
}

3. （オプション）TPMエージェントの動作を有効にする

完全な機能を体験するには、TPMエージェントの指示を追加します。

# プロジェクトの.claudeフォルダにシンボリックリンクを作成
mkdir -p .claude
ln -s /path/to/tpm-mcp/agents/tpm.md .claude/tpm.md

次に、CLAUDE.mdに以下を記述します。

See .claude/tpm.md for project tracking workflow.

💻 使用例

基本的な使用法

You: :TPM: what's in progress?

Claude: Here's your current roadmap:

# Roadmap Summary
**Stats**: 3/8 tickets, 12/25 tasks (48% complete)

## ExampleOrg
### backend-api
Tickets: 3/5 done

- [~] **FEAT-003**: Payment Integration (high)
  Tasks: 2/4
    - [~] TASK-003-1: Stripe webhook handler
    - [ ] TASK-003-2: Invoice generation

- [ ] **FEAT-004**: Email Notifications
  Tasks: 0/3

高度な使用法

You: :TPM: Add user authentication to the backend project

Claude: Created ticket FEAT-005: "User Authentication" in backend-api
        Status: backlog, Priority: medium

You: Make it high priority and break it down

Claude: Updated FEAT-005 to high priority. Created tasks:
        - TASK-005-1: Design auth schema
        - TASK-005-2: Implement JWT middleware
        - TASK-005-3: Add login/logout endpoints
        - TASK-005-4: Write auth tests

You: Starting on the JWT middleware

Claude: Marked TASK-005-2 as in-progress.
        FEAT-005 is now in-progress.

You: Done with middleware, tests pass

Claude: Marked TASK-005-2 as done (1/4 tasks complete)

クイックコマンド

📚 ドキュメント

ツールリファレンス

データモデル

Organization
└── Project
    └── Ticket (feature/epic/bug)
        ├── Tasks
        └── Notes

チケットのステータス: backlog → planned → in-progress → done | blocked

タスクのステータス: pending → in-progress → done | blocked

優先度: critical > high > medium > low

エクスポートとインポート

プロジェクトデータをJSON形式でエクスポートおよびインポートして、バックアップ、復元、または他のツールとの相互運用性を実現します。

データのエクスポート

すべてのプロジェクトデータをJSON形式でエクスポートします。

# 標準出力にエクスポート
uv run tpm-json-export

# ファイルにエクスポート
uv run tpm-json-export -o backup.json

# カスタムデータベースからエクスポート
uv run tpm-json-export --db-path /path/to/custom.db -o backup.json

データのインポート

JSONエクスポートファイルからデータをインポートして、データベースを再作成またはバックアップから復元します。

# インポートせずにJSONファイルを検証
uv run tpm-json-import --dry-run backup.json

# デフォルトのデータベースにインポート
uv run tpm-json-import backup.json

# カスタムデータベースにインポート
uv run tpm-json-import --db-path /path/to/db.db backup.json

# 既存のデータをクリアしてインポート
uv run tpm-json-import --clear backup.json

PDFステータスレポート

プロジェクトデータから美しく共有可能なPDFレポートを生成します。

# スキルをプロジェクトにコピー
cp -r /path/to/tpm-mcp/skills/tpm-report .claude/skills/

You: Generate a project status report

Claude: [Fetches roadmap data, generates styled HTML, converts to PDF]
        PDF report saved to: Project-Status-2025-12-02.pdf

# Playwright MCPを追加（PDF生成にはヘッドレスモードが推奨）
claude mcp add playwright-headless --scope user -- npx @playwright/mcp@latest --headless

# または、分離モード（別のブラウザプロファイル）で追加
claude mcp add playwright-headless --scope user -- npx @playwright/mcp@latest --isolated --headless

{
  "mcpServers": {
    "playwright-headless": {
      "command": "npx",
      "args": ["@playwright/mcp@latest", "--headless"]
    }
  }
}

You: :TPM: show me the roadmap as JSON

Claude: [Returns structured JSON data]

旧トラッカーからの移行

異なる形式の旧JSONベースのトラッカーから移行する場合は、次のコマンドを実行します。

uv run tpm-migrate /path/to/old-tracker

このツールは、古いJSONトラッカー形式からの変換を行います。標準的なエクスポート/インポートには、上記のtpm-json-exportとtpm-json-importを使用してください。

開発

# 開発用依存関係を含めてインストール
uv pip install -e ".[dev]"

# テストを実行
uv run pytest tests/ -v

ローカルでの理由

• プライバシー: プロジェクトデータはマシンを離れません
• 速度: SQLiteはこのユースケースで非常に高速です
• 信頼性: APIのレート制限や停止がなく、オフラインでも動作します
• シンプルさ: 1つのデータベースファイルで、バックアップや同期が簡単です

📄 ライセンス

MITライセンスです。自由に使用できます。

引用

@software{Bhatia_TPM-MCP_A_Local_2025,
  author = {Bhatia, Urjit Singh},
  license = {MIT},
  title = {{TPM-MCP: A Local Technical Product Manager MCP Server}},
  url = {https://github.com/urjitbhatia/tpm-mcp},
  year = {2025}
}