Feedback Synthesis MCP

Feedback Synthesis MCP

AI エージェントや開発者向けの顧客フィードバックインテリジェンスです。GitHub の Issue、Hacker News のスレッド、App Store のレビューを、根拠へのリンク付きで優先順位を付けた課題クラスターにまとめます。x402 のマイクロペイメントによる従量課金で、サインアップは不要です。

何百ものフィードバック項目を手作業で読み込む必要はありません。Feedback Synthesis MCP は複数のソースから情報を収集し、複数段階の LLM パイプラインを実行して、影響度スコア、根拠へのリンク、推奨アクション付きの優先順位を付けた課題クラスターを返します。エージェント向けには機械可読形式、創業者向けには人間が読みやすい形式です。

クイックスタート

インストール：

pip install feedback-synthesis-mcp

ウォレットキーを設定（Base メインネット上の任意の 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"
      }
    }
  }
}

クライアントを再起動します。4 つの顧客インテリジェンスツールが利用できるようになります。

---

ツール

ツール	内容	価格
synthesize_feedback	複数ソースの統合 → 根拠付きの優先順位を付けた課題クラスター	1 回あたり $0.05
get_pain_points	単一ソースから課題をすばやく抽出	1 回あたり $0.02
search_feedback	キャッシュされたフィードバック項目を全文検索	1 回あたり $0.01
get_sentiment_trends	複数のソースにわたる時系列の感情分析	1 回あたり $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 メインネット（USDC）上の x402 マイクロペイメントを使用します。必要なもの：

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（Streamable HTTP トランスポート）

プログラムやエージェントからアクセスする場合は、PyPI パッケージを使わず、ホスト型 MCP エンドポイントを直接利用できます：

MCP サーバー URL：https://feedback-synthesis-mcp-production.up.railway.app/mcp/

Streamable HTTP トランスポートに対応する MCP クライアント（HTTP 経由の Claude Desktop、カスタムエージェントなど）向け：

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

x402 の支払いはクライアント SDK によって自動的に処理されます。環境に EVM_PRIVATE_KEY を設定してください。

---

---

ライセンス

MIT