开源MCP工具

Quick Start

git clone https://github.com/dkships/pm-copilot.git
cd pm-copilot
npm install
cp .env.example .env   # Edit with your credentials
npm run build

Example output

A trimmed synthesize_feedback response at the default summary detail level. Values are illustrative; note the PII scrubbing applied to the customer quote.

{
  "timeframe_days": 30,
  "detail_level": "summary",
  "portal_name": "all",
  "fetched_at": "2026-06-01T16:00:00.000Z",
  "pii_scrubbing_applied": true,
  "pii_categories_redacted": ["email", "phone"],
  "analysis": {
    "total_data_points": 612,
    "reactive_count": 548,
    "proactive_count": 64,
    "themes": [
      {
        "theme_id": "booking-scheduling",
        "label": "Booking & Scheduling",
        "category": "Core Product",
        "priority_score": 87.1,
        "convergent": true,
        "signal_type": "convergent",
        "reactive_count": 211,
        "proactive_count": 19,
        "evidence_summary": "230 signals (211 tickets, 19 requests). Convergent across both sources.",
        "representative_quotes": [
          "[Support ticket] \"Double-booked slots again after the timezone change — reach me at [EMAIL REDACTED]\"",
          "[Feature request, 47 votes] \"Let me block buffer time between meetings\""
        ]
      },
      {
        "theme_id": "billing-payment",
        "label": "Billing & Payment",
        "category": "Monetization",
        "priority_score": 64.3,
        "convergent": false,
        "signal_type": "reactive",
        "reactive_count": 188,
        "proactive_count": 0,
        "evidence_summary": "188 signals (188 tickets, 0 requests). Reactive only.",
        "representative_quotes": [
          "[Support ticket] \"Charged twice for the annual plan\""
        ]
      }
    ],
    "emerging_themes": [
      { "pattern": "csv export", "frequency": 12 }
    ],
    "unmatched_count": 38
  }
}

Theme configuration

themes.config.json in the project root defines what themes to look for. Edit without rebuilding — loaded at runtime.

Ships with 16 data-driven themes across 9 categories. Add your own by appending to the themes array. Unmatched data points are analyzed for emerging patterns using bigram/trigram frequency detection.

Troubleshooting

- Changes aren't taking effect. The MCP client runs the compiled dist/. After editing source, run npm run build and restart the client (or the MCP server connection) to pick up new code. - No HelpScout mailbox named "…". Run list_sources to see the exact mailbox names, or pass the numeric mailbox_id directly. - No portal found with name "…" / portal missing. The portal must be configured in PRODUCTLIFT_PORTALS (or the single-portal env vars). Run list_sources to see configured portals.