Feedback Synthesis MCP

Feedback Synthesis MCP

为 AI Agent 和开发者提供客户反馈洞察。将 GitHub Issues、Hacker News 讨论串和 App Store 评论综合为带有证据链接的痛点排名。通过 x402 微支付按次付费——无需注册。

不必再手动阅读数百条反馈。Feedback Synthesis MCP 从多个来源收集反馈，运行多轮大模型处理流程，并返回按影响力评分排序的痛点，附带证据链接和建议措施——机器可读，方便 Agent 使用；人类可读，方便创始人查看。

快速开始

安装：

pip install feedback-synthesis-mcp

设置钱包密钥（任意在 Base 主网上持有 USDC 的 EVM 钱包）：

export EVM_PRIVATE_KEY=your_private_key_here

添加到 Claude Desktop——编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "feedback-synthesis-mcp": {
      "command": "feedback-synthesis-mcp",
      "env": {
        "EVM_PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}

添加到 Cursor——编辑项目根目录中的 .cursor/mcp.json：

{
  "mcpServers": {
    "feedback-synthesis-mcp": {
      "command": "feedback-synthesis-mcp",
      "env": {
        "EVM_PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}

重启客户端。现在你可以使用四种客户洞察工具。

---

工具

工具	功能	价格
synthesize_feedback	综合多个来源 → 按排名排列的痛点，并附带证据	$0.05/次调用
get_pain_points	快速提取单一来源中的痛点	$0.02/次调用
search_feedback	在缓存的反馈条目中进行全文搜索	$0.01/次调用
get_sentiment_trends	分析不同来源的情绪随时间变化趋势	$0.03/次调用

支持的来源：GitHub Issues、Hacker News、Apple App Store 评论

---

示例

综合多个来源的反馈

synthesize_feedback(
  sources=[
    {"type": "github_issues", "target": "owner/my-repo", "labels": ["bug", "feature-request"]},
    {"type": "hackernews", "target": "Show HN: MyProduct"}
  ],
  since="2026-01-01T00:00:00Z"
)

返回：

{
  "job_id": "syn_abc123",
  "status": "completed",
  "summary": "Analyzed 347 feedback items from 2 sources. Found 6 pain clusters.",
  "pain_clusters": [
    {
      "rank": 1,
      "title": "Authentication flow breaks on mobile Safari",
      "severity": "critical",
      "frequency": 23,
      "impact_score": 0.92,
      "description": "Users report inability to complete OAuth login on iOS Safari. Affects onboarding conversion.",
      "evidence": [
        {
          "source": "github",
          "url": "https://github.com/owner/my-repo/issues/142",
          "snippet": "Login fails silently on Safari 17.2+"
        }
      ],
      "suggested_actions": [
        "Fix Safari WebAuthn polyfill (see issue #142)",
        "Add fallback auth flow for mobile browsers"
      ]
    }
  ]
}

快速提取 GitHub Issues 中的痛点

get_pain_points(
  source={"type": "github_issues", "target": "owner/my-repo", "labels": ["bug"]},
  top_n=5
)

搜索特定主题

search_feedback(query="pricing too expensive", sources=["github_issues", "hackernews"])

跟踪情绪随时间的变化

get_sentiment_trends(
  sources=[{"type": "appstore", "target": "com.example.myapp"}],
  since="2025-10-01T00:00:00Z",
  granularity="weekly"
)

---

付款

此 MCP 在 Base 主网上使用 x402 微支付（USDC）。你需要：

1. 一个在 Base 主网上持有 USDC 的 EVM 钱包
2. 将钱包的私钥设置为 EVM_PRIVATE_KEY

每次调用费用为 $0.01–$0.05 USDC。付款自动完成——无需订阅，也无需 API 密钥。

尚未配置付款？ 服务会返回包含设置说明的实用错误提示。

---

架构

此软件包是一个轻量级 MCP 客户端。所有处理都在托管后端进行：

Your Agent / Claude Desktop
        │
        ▼
feedback-synthesis-mcp (this package)
  - MCP tool definitions
  - x402 payment signing
  - Zero business logic
        │ HTTPS + x402
        ▼
Hosted Backend (Railway)
  - Multi-source data collection
  - 3-stage LLM pipeline (Haiku × N + Sonnet × 1)
  - SQLite caching + FTS search
  - x402 payment verification

服务端代码为私有（核心优势）。轻量级客户端为开源。

通过 HTTP 直接使用 MCP（可流式 HTTP 传输）

如需以编程方式访问或供 Agent 使用，可跳过 PyPI 软件包，直接使用托管的 MCP 端点：

MCP 服务 URL：https://feedback-synthesis-mcp-production.up.railway.app/mcp/

适用于支持可流式 HTTP 传输的 MCP 客户端（通过 HTTP 连接的 Claude Desktop、自定义 Agent）：

{
  "mcpServers": {
    "feedback-synthesis-mcp": {
      "type": "streamable-http",
      "url": "https://feedback-synthesis-mcp-production.up.railway.app/mcp/"
    }
  }
}

x402 付款由客户端 SDK 自动处理。请在环境中设置 EVM_PRIVATE_KEY。

---

---

许可证

MIT