Feedback Synthesis MCP

Feedback Synthesis MCP

Inteligência de feedback de clientes para agentes de IA e desenvolvedores. Sintetize Issues do GitHub, discussões do Hacker News e avaliações da App Store em clusters de dor ranqueados com links de evidência. Pagamento por chamada via micropagamentos x402 — sem necessidade de cadastro.

Pare de ler centenas de itens de feedback manualmente. O Feedback Synthesis MCP coleta de múltiplas fontes, executa um pipeline de LLM de múltiplas passagens e retorna clusters de dor ranqueados com pontuações de impacto, links de evidência e ações sugeridas — legível por máquinas para agentes, legível por humanos para fundadores.

Início Rápido

Instalação:

pip install feedback-synthesis-mcp

Defina sua chave de carteira (qualquer carteira EVM com USDC na Base mainnet):

export EVM_PRIVATE_KEY=your_private_key_here

Adicione ao Claude Desktop — edite ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Adicione ao Cursor — edite .cursor/mcp.json na raiz do seu projeto:

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

Reinicie seu cliente. Agora você tem quatro ferramentas de inteligência de clientes disponíveis.

---

Ferramentas

Ferramenta	O que faz	Preço
synthesize_feedback	Síntese multi-fonte → clusters de dor ranqueados com evidências	$0,05/chamada
get_pain_points	Extração rápida de pontos de dor de fonte única	$0,02/chamada
search_feedback	Busca de texto completo em itens de feedback em cache	$0,01/chamada
get_sentiment_trends	Sentimento em série temporal entre fontes	$0,03/chamada

Fontes suportadas: Issues do GitHub, Hacker News, Avaliações da Apple App Store

---

Exemplos

Sintetize feedback de múltiplas fontes

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"
)

Retorna:

{
  "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"
      ]
    }
  ]
}

Pontos de dor rápidos de Issues do GitHub

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

Busque por tópicos específicos

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

Acompanhe o sentimento ao longo do tempo

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

---

Pagamento

Este MCP usa micropagamentos x402 na Base mainnet (USDC). Você precisa de:

1. Uma carteira EVM com USDC na Base mainnet
2. A chave privada da carteira definida como EVM_PRIVATE_KEY

Cada chamada custa $0,01–$0,05 USDC. Os pagamentos são feitos automaticamente — sem assinaturas, sem chaves de API.

Sem pagamento configurado? O servidor retorna um erro útil com instruções de configuração.

---

Arquitetura

Este pacote é um cliente MCP leve. Todo o processamento acontece no backend hospedado:

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

O código do servidor é privado (moat). O cliente leve é open source.

MCP Direto via HTTP (Transporte HTTP Streamable)

Pule o pacote PyPI para acesso programático/agente usando o endpoint MCP hospedado diretamente:

URL do Servidor MCP: https://feedback-synthesis-mcp-production.up.railway.app/mcp/

Para clientes MCP que suportam transporte HTTP Streamable (Claude Desktop via HTTP, agentes personalizados):

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

O pagamento x402 é tratado automaticamente pelo SDK do cliente. Defina EVM_PRIVATE_KEY no seu ambiente.

---

---

Licença

MIT