Suppr MCP - Guía de uso | MCP service for document translation and Chinese PubMed search | Suppr Academic Literature

Servidor Suppr MCP

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 por 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, recuento 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 del Protocolo de Contexto de Modelo.

Instalación

npx suppr-mcp

Inicio rápido

1. Instalación

Instalación global:

npm install -g suppr-mcp

O utilice npx (sin necesidad de instalación):

npx suppr-mcp

2. Obtener API Key

Visite Suppr API para obtener su clave de API.

3. Configurar variables de entorno

export SUPPR_API_KEY=your_api_key_here

4. Uso en clientes 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 utilice 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 (elija entre file_path y file_url): Ruta del archivo de origen

• file_url (elija entre file_path y file_url): 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
}

Respuesta:

{
  "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 información detallada 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"
}

Respuesta:

{
  "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 del estado de la tarea:

• INIT: Inicializado

• PROGRESS: En progreso

• DONE: Completado

• ERROR: Error

3. list_translations - Listar tareas de traducción

Obtiene una lista de tareas de traducción, admite paginación.

Parámetros:

• offset (opcional): Desplazamiento de paginación, por defecto 0

• limit (opcional): Cantidad por página, por defecto 20

Ejemplo:

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

Respuesta:

{
  "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): Cantidad máxima de resultados (1-100, por defecto 20)

• return_doc_keys (opcional): Especificar campos de retorno

• auto_select (opcional): Selección automática de los mejores resultados (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

• Consulte la documentación de la API para más campos

Respuesta:

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

Idiomas admitidos

Códigos de idiomas comunes:

• en: Inglés

• zh: Chino

• ko: Coreano

• ja: Japonés

• fr: Francés

• de: Alemán

• es: Español

• ru: Ruso

• ar: Árabe

• pt: Portugués

• it: 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 de API inválida o no proporcionada

• 400: Error en los parámetros de la solicitud

• 404: El recurso no existe

Ejemplos de uso

Uso en Claude Desktop

1. Después de configurar la clave de API, reinicie Claude Desktop

2. Utilice las herramientas en la conversación:

Traducir documento:

Por favor, ayúdame a traducir este documento: https://example.com/paper.pdf, al inglés

Buscar literatura:

Ayúdame a buscar la literatura más reciente sobre "aplicaciones del aprendizaje profundo en imágenes médicas"

Consultar estado de traducción:

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

Preguntas frecuentes

P: ¿Cómo obtengo una clave de API?

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

P: ¿Qué formatos de documento se admiten?

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

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

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

P: ¿Cómo descargo el documento traducido?

R: Una vez completada la traducción, get_translation devolverá target_file_url, acceda directamente a ese enlace para descargar.

P: ¿Falla la ejecución de npx?

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

🔗 Productos de Suppr

• Plugin de Zotero : https://github.com/WildDataX/suppr-zotero-plugin

• Sitio web oficial: https://suppr.wilddata.cn

• Traducción de documentos por IA: https://suppr.wilddata.cn/translate/upload

• Servicio API: https://openapi.suppr.wilddata.cn/introduction

• Búsqueda en Pubmed: https://suppr.wilddata.cn/

• Investigación profunda: https://suppr.wilddata.cn/deep-research

• Organización de GitHub: WildDataX

Soporte técnico

Si necesita ayuda, contacte a: IT@wilddata.cn

Hecho con ❤️ por WildData

Ecosistema Suppr