MewCP Perplexity MCP

Servidor MCP de Perplexity alojado, sin estado y multiinquilino que permite a los asistentes de IA realizar investigaciones web y recuperar resultados de búsqueda impulsados por IA a través de Perplexity.

GitHubPrueba este MCPPatrocinado

Documentación

Responde cualquier pregunta con búsqueda web en vivo, citas y razonamiento de IA, todo en una sola llamada.

Un servidor de Model Context Protocol (MCP) que expone la API de Perplexity AI para búsqueda web en tiempo real y consultas conversacionales con fuentes citadas.

Descripción general

El servidor MCP de Perplexity proporciona búsqueda web impulsada por IA con respuestas fundamentadas y respaldadas por citas:

  • Consulta la web en vivo y obtén respuestas sintetizadas por LLM con referencias a fuentes
  • Controla la longitud de la respuesta, la temperatura y el modelo de búsqueda subyacente
  • Explora los modelos de Perplexity disponibles para elegir la capacidad adecuada para cada tarea

Perfecto para:

  • Dar a los asistentes de IA acceso a eventos actuales, noticias e información en tiempo real
  • Responder preguntas de investigación que requieren datos actualizados más allá del corte de entrenamiento del modelo
  • Enriquecer los flujos de trabajo de IA con fuentes web citadas y verificables

Herramientas

health_check — Comprueba la disponibilidad del servidor

Devuelve un objeto de estado que confirma que el servidor está en ejecución y es accesible.

Entradas: (ninguna)

Salida:

{
  "status": "ok",
  "server": "CL Perplexity MCP Server"
}
search — Busca en la web con Perplexity AI

Envía una consulta a los modelos de búsqueda en línea de Perplexity y devuelve una respuesta generada por LLM con citas de fuentes web en vivo.

Entradas:

- `query`       (string, required)  — Search query to look up on the web
- `model`       (string, optional)  — Model to use (default: llama-3.1-sonar-small-128k-online)
- `max_tokens`  (integer, optional) — Maximum tokens in the response, 1–4096
- `temperature` (float, optional)   — Sampling temperature 0–2; higher = more creative (default: model default)

Salida:

{
  "success": true,
  "query": "latest AI research papers 2025",
  "response": "Recent AI research has focused on...",
  "model": "llama-3.1-sonar-small-128k-online",
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 320,
    "total_tokens": 332
  }
}
get_models — Lista los modelos de Perplexity disponibles

Devuelve todos los modelos disponibles a través de la API de Perplexity, agrupados en categorías en línea (búsqueda web) y sin conexión (sin búsqueda).

Entradas: (ninguna)

Salida:

{
  "success": true,
  "total_models": 6,
  "online_models": [
    "llama-3.1-sonar-small-128k-online",
    "llama-3.1-sonar-large-128k-online",
    "llama-3.1-sonar-huge-128k-online"
  ],
  "other_models": [
    "llama-3.1-sonar-small-128k-chat",
    "llama-3.1-sonar-large-128k-chat"
  ],
  "all_models": [...]
}

Referencia de Parámetros de la API

Selección de modelo

Modelos en línea (incluyen búsqueda web en vivo):

  • llama-3.1-sonar-small-128k-online — Rápido y rentable; predeterminado para búsqueda web
  • llama-3.1-sonar-large-128k-online — Respuestas de mayor calidad, búsqueda más exhaustiva
  • llama-3.1-sonar-huge-128k-online — Mejor calidad, más completo; mayor costo

Usa get_models para recuperar la lista completa actual: se añaden nuevos modelos periódicamente.

Parámetros de generación
  • temperature — Controla la aleatoriedad; 0.0 para respuestas factuales enfocadas, 1.0+ para respuestas creativas (rango: 0–2)
  • max_tokens — Limita la longitud de la respuesta; útil para controlar el costo y la latencia (rango: 1–4096)

Cómo Obtener tu Clave de API de Perplexity

Pasos
  1. Ve a la Configuración de la API de Perplexity
  2. Inicia sesión o crea una cuenta de Perplexity
  3. En API Keys, haz clic en + Generate
  4. Copia la clave generada: guárdala de forma segura, no se mostrará de nuevo

El uso de la API de Perplexity se factura por solicitud según el modelo y el recuento de tokens. Los modelos en línea consumen créditos adicionales para la búsqueda web.

Solución de Problemas

Encabezados faltantes o no válidos
  • Causa: Clave de API no proporcionada en los encabezados de la solicitud o formato incorrecto
  • Solución:
    1. Verifica que los encabezados Authorization: Bearer YOUR_API_KEY y X-Mewcp-Credential-Id: CREDENTIAL-ID estén presentes
    2. Comprueba que la clave de API esté activa en tu cuenta de MewCP
Créditos insuficientes
  • Causa: Las llamadas a la API han superado tus límites de solicitudes
  • Solución:
    1. Consulta el uso de créditos en tu panel de Curious Layer
    2. Mejora a un plan de pago o añade créditos para límites más altos
    3. Contacta con soporte para ajustes de créditos
Credencial no conectada
  • Causa: No hay ninguna credencial de Perplexity vinculada a tu cuenta
  • Solución:
    1. Ve a Credentials en tu panel de MewCP
    2. Añade tu clave de API de Perplexity
    3. Reintenta la solicitud con el encabezado X-Mewcp-Credential-Id correcto
Carga útil de solicitud malformada
  • Causa: La carga útil JSON no es válida o le faltan campos obligatorios
  • Solución:
    1. Valida la sintaxis JSON antes de enviarla
    2. Asegúrate de que el parámetro query esté incluido y sea una cadena no vacía
    3. Comprueba que temperature esté entre 0.0 y 2.0 y que max_tokens esté entre 1 y 4096
Servidor no encontrado
  • Causa: Nombre de servidor incorrecto en el endpoint de la API
  • Solución:
    1. Verifica el formato del endpoint: {server-name}/mcp/{tool-name}
    2. Usa el nombre de servidor correcto de la documentación
    3. Consulta los servidores disponibles en tu cuenta de Curious Layer
Error de la API de Perplexity
  • Causa: La API de Perplexity upstream devolvió un error
  • Solución:
    1. Consulta el estado del servicio de Perplexity en la Página de estado de Perplexity
    2. Verifica que tu clave de API tenga suficientes créditos para el modelo seleccionado
    3. Revisa el mensaje de error para obtener detalles específicos (p. ej., límite de velocidad superado, ID de modelo no válido)
Recursos