Feedback Synthesis MCP

Feedback Synthesis MCP

Inteligencia de comentarios de clientes para agentes de IA y desarrolladores. Sintetiza Issues de GitHub, hilos de Hacker News y reseñas de App Store en grupos de dolor clasificados con enlaces de evidencia. Pago por llamada mediante micropagos x402: no se requiere registro.

Deja de leer cientos de comentarios manualmente. Feedback Synthesis MCP recopila de múltiples fuentes, ejecuta un pipeline de LLM de múltiples pasadas y devuelve grupos de dolor clasificados con puntuaciones de impacto, enlaces de evidencia y acciones sugeridas: legible por máquina para agentes, legible por humanos para fundadores.

Inicio rápido

Instalación:

pip install feedback-synthesis-mcp

Configura tu clave de wallet (cualquier wallet EVM con USDC en Base mainnet):

export EVM_PRIVATE_KEY=your_private_key_here

Añade a Claude Desktop — edita ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Añade a Cursor — edita .cursor/mcp.json en la raíz de tu proyecto:

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

Reinicia tu cliente. Ahora tienes cuatro herramientas de inteligencia de clientes disponibles.

---

Herramientas

Herramienta	Qué hace	Precio
synthesize_feedback	Síntesis multi-fuente → grupos de dolor clasificados con evidencia	$0.05/llamada
get_pain_points	Extracción rápida de puntos de dolor de una sola fuente	$0.02/llamada
search_feedback	Búsqueda de texto completo en elementos de comentarios en caché	$0.01/llamada
get_sentiment_trends	Sentimiento de series temporales entre fuentes	$0.03/llamada

Fuentes compatibles: Issues de GitHub, Hacker News, reseñas de Apple App Store

---

Ejemplos

Sintetizar comentarios de múltiples fuentes

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

Devuelve:

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

Puntos de dolor rápidos desde Issues de GitHub

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

Buscar temas específicos

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

Rastrear sentimiento a lo largo del tiempo

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

---

Pago

Este MCP utiliza micropagos x402 en Base mainnet (USDC). Necesitas:

1. Una wallet EVM con USDC en Base mainnet
2. La clave privada de la wallet configurada como EVM_PRIVATE_KEY

Cada llamada cuesta $0.01–$0.05 USDC. Los pagos se realizan automáticamente: sin suscripciones, sin claves API.

¿Sin pago configurado? El servidor devuelve un error útil con instrucciones de configuración.

---

Arquitectura

Este paquete es un cliente MCP ligero. Todo el procesamiento ocurre en el backend alojado:

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

El código del servidor es privado (foso). El cliente ligero es de código abierto.

MCP directo sobre HTTP (Transporte HTTP Streamable)

Omite el paquete PyPI para acceso programático/agente usando el endpoint MCP alojado directamente:

URL del servidor MCP: https://feedback-synthesis-mcp-production.up.railway.app/mcp/

Para clientes MCP que soporten transporte HTTP Streamable (Claude Desktop vía HTTP, agentes personalizados):

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

El pago x402 se maneja automáticamente por el SDK del cliente. Configura EVM_PRIVATE_KEY en tu entorno.

---

---

Licencia

MIT