Productplan MCP Server

1. 設定ファイルを見つけます。
   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. 任意のテキストエディタで開き、以下を追加します（your-tokenを実際のAPIトークンに置き換えてください）。

Mac/Linux:

{
  "mcpServers": {
    "productplan": {
      "command": "/usr/local/bin/productplan",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "productplan": {
      "command": "C:\\Tools\\productplan.exe",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

3. Claude Desktopを再起動します。

設定ファイルに以下を追加します。

• Mac/Linux: ~/.claude.json
• Windows: %USERPROFILE%\.claude.json

Mac/Linux:

{
  "mcpServers": {
    "productplan": {
      "command": "/usr/local/bin/productplan",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "productplan": {
      "command": "C:\\Tools\\productplan.exe",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

1. Cursorを開きます。
2. 設定 → MCP Serversに移動します。
3. 以下の設定を追加します。

Mac/Linux:

{
  "productplan": {
    "command": "/usr/local/bin/productplan",
    "env": {
      "PRODUCTPLAN_API_TOKEN": "your-token"
    }
  }
}

Windows:

{
  "productplan": {
    "command": "C:\\Tools\\productplan.exe",
    "env": {
      "PRODUCTPLAN_API_TOKEN": "your-token"
    }
  }
}

Windowsユーザー: パスにはダブルバックスラッシュ (\\) を使用してください。JSONではバックスラッシュはエスケープ文字として扱われるため、これが必要です。

1. Cline拡張機能をインストールします。
2. VS Codeの設定（JSON）を開き、以下を追加します。

Mac/Linux:

{
  "cline.mcpServers": {
    "productplan": {
      "command": "/usr/local/bin/productplan",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

Windows:

{
  "cline.mcpServers": {
    "productplan": {
      "command": "C:\\Tools\\productplan.exe",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

1. Continue拡張機能をインストールします。
2. 設定ファイルに以下を追加します。
   • Mac/Linux: ~/.continue/config.json
   • Windows: %USERPROFILE%\.continue\config.json

Mac/Linux:

{
  "mcpServers": [
    {
      "name": "productplan",
      "command": "/usr/local/bin/productplan",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  ]
}

Windows:

{
  "mcpServers": [
    {
      "name": "productplan",
      "command": "C:\\Tools\\productplan.exe",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  ]
}

1. n8nインスタンスで環境変数を設定します。

   N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
   

2. ワークフローにMCP Clientノードを追加します。
3. 以下のように設定します。
   • コマンド:
     • Mac/Linux: /usr/local/bin/productplan
     • Windows: C:\Tools\productplan.exe
   • 環境変数: PRODUCTPLAN_API_TOKEN=your-token
4. AI Agentノードに接続します。

例のワークフロー: Slack Trigger → AI Agent (with MCP Client) → Slack Response

productplan-mcp-server/
├── cmd/productplan/main.go      # エントリーポイント (~100行)
├── internal/
│   ├── api/                     # ProductPlan APIクライアント
│   │   ├── client.go            # キャッシュ、リトライ、レート制限付きのHTTPクライアント
│   │   ├── endpoints.go         # 40以上のAPIエンドポイントメソッド
│   │   └── formatters.go        # AI用の応答エンリッチメント
│   ├── mcp/                     # MCPプロトコルの実装
│   │   ├── server.go            # JSON-RPCサーバー、標準入出力
│   │   ├── handler.go           # レジストリを介したツールディスパッチ
│   │   └── types.go             # プロトコルタイプ
│   ├── tools/                   # ツールの定義とハンドラー
│   │   ├── registry.go          # ツールの登録とディスパッチ
│   │   └── types.go             # ハンドラー用の型付き引数構造体
│   ├── cli/                     # CLIコマンド (status, roadmapsなど)
│   │   └── cli.go
│   └── logging/                 # 構造化JSONロギング
│       └── logger.go
├── pkg/productplan/             # 再利用可能なユーティリティ
│   ├── cache.go                 # TTL付きのLRUキャッシュ
│   ├── retry.go                 # ジッター付きの指数バックオフ
│   ├── ratelimit.go             # 適応型レート制限
│   ├── registry.go              # スキーマ生成用のToolBuilder
│   ├── requestid.go             # リクエストトレーシング
│   └── errors.go                # エラー提案
└── evals/                       # LLM評価テストスイート
    ├── tool_selection.json
    ├── confusion_pairs.json
    └── argument_correctness.json

git clone https://github.com/olgasafonova/productplan-mcp-server.git
cd productplan-mcp-server
go build -o productplan ./cmd/productplan

すべてのプラットフォーム用にビルドする:

# macOS Apple Silicon
GOOS=darwin GOARCH=arm64 go build -o dist/productplan-darwin-arm64 ./cmd/productplan

# macOS Intel
GOOS=darwin GOARCH=amd64 go build -o dist/productplan-darwin-amd64 ./cmd/productplan

# Linux
GOOS=linux GOARCH=amd64 go build -o dist/productplan-linux-amd64 ./cmd/productplan

# Windows
GOOS=windows GOARCH=amd64 go build -o dist/productplan-windows-amd64.exe ./cmd/productplan

すべてのテストを実行する:

go test ./...

カバレッジ付きで実行する:

go test ./... -cover

ベンチマークを実行する:

go test ./internal/... -bench=. -benchmem

評価スイートを実行する:

./scripts/run-evals.sh

カバレッジ目標:

47のツールが利用可能です: 35のREADツールと12のWRITEツール (アクションベース)。

読み取りツール:

• ロードマップ: list_roadmaps, get_roadmap, get_roadmap_bars, get_roadmap_lanes, get_roadmap_milestones, get_roadmap_legends, get_roadmap_comments, get_roadmap_complete
• バー: get_bar, get_bar_children, get_bar_comments, get_bar_connections, get_bar_links
• OKR: list_objectives, get_objective, list_key_results, get_key_result
• ディスカバリー: list_ideas, get_idea, list_all_customers, list_all_tags, list_opportunities, get_opportunity, list_idea_forms, get_idea_form
• ローンチ: list_launches, get_launch, get_launch_sections, get_launch_section, get_launch_tasks, get_launch_task
• 管理: check_status, health_check, list_users, list_teams

書き込みツール:

• ロードマップ: manage_bar, manage_lane, manage_milestone
• バーの関係: manage_bar_connection, manage_bar_link
• OKR: manage_objective, manage_key_result
• ディスカバリー: manage_idea, manage_opportunity
• ローンチ: manage_launch, manage_launch_section, manage_launch_task

例:

{"tool": "list_roadmaps", "arguments": {}}
{"tool": "manage_bar", "arguments": {"action": "create", "roadmap_id": "123", "lane_id": "456", "name": "New feature"}}
{"tool": "manage_idea", "arguments": {"action": "create", "name": "Mobile app improvements"}}

サーバーはクリーンなレイヤードアーキテクチャを使用しています。

┌──────────────────────────────────────────────────────────────┐
│                        cmd/productplan                        │
│                     (entry point, DI)                         │
└──────────────────────────────────────────────────────────────┘
                              │
        ┌─────────────────────┼─────────────────────┐
        ▼                     ▼                     ▼
┌───────────────┐    ┌───────────────┐    ┌───────────────┐
│  internal/cli │    │  internal/mcp │    │internal/tools │
│  (CLI cmds)   │    │ (JSON-RPC IO) │    │  (handlers)   │
└───────────────┘    └───────────────┘    └───────────────┘
                              │                     │
                              └──────────┬──────────┘
                                         ▼
                              ┌───────────────────┐
                              │   internal/api    │
                              │  (HTTP client)    │
                              └───────────────────┘
                                         │
                                         ▼
                              ┌───────────────────┐
                              │  ProductPlan API  │
                              └───────────────────┘

主要なインターフェース:

// ツールハンドラーインターフェース (internal/mcp)
type Handler interface {
    Handle(ctx context.Context, args map[string]any) (json.RawMessage, error)
}

// ロガーインターフェース (internal/logging)
type Logger interface {
    Debug(msg string, fields ...Field)
    Info(msg string, fields ...Field)
    Warn(msg string, fields ...Field)
    Error(msg string, fields ...Field)
}

ロギング形式:

{"ts":"2024-12-26T10:30:00Z","level":"info","req_id":"ab12","op":"get_roadmap_bars","dur_ms":245}