Suppr-MCP (超能文献)

Servicio de traducción de documentos y búsqueda académica impulsado por IA. Admite traducción de alta calidad en 11 idiomas para formatos como PDF, DOCX y PPTX, con manejo optimizado de fórmulas matemáticas. Incluye búsqueda inteligente de literatura integrada con PubMed para investigadores. https://suppr.wilddata.cn/

Documentación

Suppr MCP - Guía de uso | Servicio MCP de traducción de documentos y búsqueda de PubMed en chino | Suppr超能文献

Suppr MCP Server

Suppr (超能文献) es una plataforma de herramientas académicas impulsada por IA de WildData. Este servidor MCP aporta capacidades de traducción de documentos y búsqueda de literatura a los asistentes de IA.

🌐 Traducción de documentos con IA — Traduce documentos PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), TXT y HTML en 13 idiomas. Conserva el formato original. Detección automática del idioma de origen.

🔬 Búsqueda académica en PubMed — Descubrimiento semántico de literatura en millones de artículos de investigación biomédica. Devuelve metadatos estructurados: DOI, PMID, factor de impacto de la revista, número de citas, afiliaciones de autores, resúmenes y enlaces directos a los artículos.

🤖 Compatible con MCP — Funciona con Claude Desktop, Cursor, Windsurf y cualquier cliente Model Context Protocol.

npm version License: MIT

Instalación

\`bash npx suppr-mcp \`

Inicio rápido

1. Instalación

Instalación global:

npm install -g suppr-mcp

O use npx (sin instalación):

npx suppr-mcp

2. Obtener una clave API

Visite Suppr API para obtener su clave API.

3. Configurar variables de entorno

export SUPPR_API_KEY=your_api_key_here

4. Usar en el cliente MCP

Configuración de Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o el archivo de configuración correspondiente:

{
  "mcpServers": {
    "suppr": {
      "command": "npx",
      "args": ["-y", "suppr-mcp"],
      "env": {
        "SUPPR_API_KEY": "your_api_key_here"
      }
    }
  }
}

O use la instalación global:

{
  "mcpServers": {
    "suppr": {
      "command": "suppr-mcp",
      "env": {
        "SUPPR_API_KEY": "your_api_key_here"
      }
    }
  }
}

Herramientas disponibles

1. create_translation - Crear tarea de traducción

Crea una tarea de traducción de documentos.

Parámetros:

  • file_path (file_path y file_url, elegir uno): Ruta del archivo de origen
  • file_url (file_path y file_url, elegir uno): URL del documento a traducir
  • to_lang (obligatorio): Código del idioma de destino
  • from_lang (opcional): Código del idioma de origen (detección automática por defecto)
  • optimize_math_formula (opcional): Optimizar fórmulas matemáticas (solo PDF)

Ejemplo:

{
  "file_url": "https://example.com/document.pdf",
  "to_lang": "en",
  "from_lang": "zh",
  "optimize_math_formula": true
}

Devuelve:

{
  "task_id": "02a6c6d1-3f70-4a5a-80bc-971d53a37bb1",
  "status": "INIT",
  "consumed_point": 453,
  "source_lang": "zh",
  "target_lang": "en",
  "optimize_math_formula": true
}

2. get_translation - Obtener detalles de la traducción

Obtiene la información y el estado de una tarea de traducción.

Parámetros:

  • task_id (obligatorio): ID de la tarea de traducción

Ejemplo:

{
  "task_id": "02a6c6d1-3f70-4a5a-80bc-971d53a37bb1"
}

Devuelve:

{
  "task_id": "02a6c6d1-3f70-4a5a-80bc-971d53a37bb1",
  "status": "DONE",
  "progress": 1.0,
  "consumed_point": 453,
  "source_file_name": "document.pdf",
  "source_file_url": "https://example.com/source.pdf",
  "target_file_url": "https://example.com/translated.pdf",
  "source_lang": "zh",
  "target_lang": "en",
  "error_msg": null,
  "optimize_math_formula": true
}

Descripción de los estados de la tarea:

  • INIT: Inicialización
  • PROGRESS: En curso
  • DONE: Completada
  • ERROR: Error

3. list_translations - Listar tareas de traducción

Obtiene la lista de tareas de traducción, con soporte de paginación.

Parámetros:

  • offset (opcional): Desplazamiento de paginación, por defecto 0
  • limit (opcional): Número de elementos por página, por defecto 20

Ejemplo:

{
  "offset": 0,
  "limit": 10
}

Devuelve:

{
  "total": 42,
  "offset": 0,
  "limit": 10,
  "list": [
    {
      "task_id": "...",
      "status": "DONE",
      "progress": 1.0,
      ...
    }
  ]
}

4. search_documents - Búsqueda de literatura

Búsqueda semántica de literatura impulsada por IA.

Parámetros:

  • query (obligatorio): Consulta en lenguaje natural
  • topk (opcional): Número máximo de resultados (1-100, por defecto 20)
  • return_doc_keys (opcional): Campos de retorno especificados
  • auto_select (opcional): Selección automática del mejor resultado (por defecto true)

Ejemplo:

{
  "query": "糖尿病最新研究进展",
  "topk": 5,
  "return_doc_keys": ["title", "abstract", "doi", "authors"],
  "auto_select": true
}

Campos de retorno disponibles:

  • title: Título
  • abstract: Resumen
  • authors: Lista de autores
  • doi: DOI
  • pmid: ID de PubMed
  • link: Enlace
  • publication: Publicación
  • pub_year: Año de publicación
  • Más campos en la documentación de la API

Devuelve:

{
  "search_items": [
    {
      "doc": {
        "title": "...",
        "abstract": "...",
        "authors": [...],
        "doi": "...",
        ...
      },
      "search_gateway": "pubmed"
    }
  ],
  "consumed_points": 20
}

Idiomas compatibles

Códigos de idioma comunes:

  • en: English (inglés)
  • zh: Chinese (chino)
  • ko: Korean (coreano)
  • ja: Japanese (japonés)
  • fr: French (francés)
  • de: German (alemán)
  • es: Spanish (español)
  • ru: Russian (ruso)
  • ar: Arabic (árabe)
  • pt: Portuguese (portugués)
  • it: Italian (italiano)
  • auto: Detección automática

Manejo de errores

Todos los errores devuelven un formato estándar:

{
  "code": 非零错误码,
  "msg": "错误信息",
  "data": null
}

Errores comunes:

  • 401: Clave API no válida o no proporcionada
  • 400: Error en los parámetros de la solicitud
  • 404: Recurso no encontrado

Ejemplos de uso

En Claude Desktop

  1. Reinicie Claude Desktop después de configurar la clave API

  2. Use las herramientas en la conversación:

Traducir documento:

Por favor, traduzca este documento: https://example.com/paper.pdf, al inglés

Buscar literatura:

Busque los artículos más recientes sobre "aplicaciones del aprendizaje profundo en imágenes médicas"

Consultar estado de traducción:

Ver el progreso de traducción de la tarea 02a6c6d1-3f70-4a5a-80bc-971d53a37bb1

Preguntas frecuentes

P: ¿Cómo obtener una clave API?

R: Visite https://suppr.wilddata.cn/api-keys para registrarse y obtener su clave API.

P: ¿Qué formatos de documentos se admiten?

R: Se admiten formatos comunes como PDF, DOCX, PPTX, XLSX, HTML, TXT, EPUB, etc.

P: ¿Cuánto tarda la traducción?

R: Depende del tamaño del documento, normalmente de unos minutos a más de diez minutos. Puede usar get_translation para consultar el progreso.

P: ¿Cómo descargar el documento traducido?

R: Cuando la traducción se complete, get_translation devolverá target_file_url, acceda directamente a ese enlace para descargarlo.

P: ¿Falla la ejecución con npx?

R: Asegúrese de que la versión de Node.js sea >= 18.0.0 y de que la variable de entorno SUPPR_API_KEY esté configurada.

🔗 Productos Suppr超能文献

Soporte técnico

Para obtener ayuda, contacte: IT@wilddata.cn

Hecho con ❤️ por WildData

Ecosistema Suppr

ProductoEnlace
🌐 Plataforma Supprsuppr.wilddata.cn
📖 Documentación de la APIopenapi.suppr.wilddata.cn
🔌 Plugin de Zoterosuppr-zotero-plugin
🤖 Habilidades de Claude Codesuppr-skills
🔬 Investigación profundasuppr.wilddata.cn/deep-research
📄 Traducción con IAsuppr.wilddata.cn/translate/upload
🔎 Búsqueda en PubMedsuppr.wilddata.cn