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.
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 origenfile_url(file_path y file_url, elegir uno): URL del documento a traducirto_lang(obligatorio): Código del idioma de destinofrom_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ónPROGRESS: En cursoDONE: CompletadaERROR: 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 0limit(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 naturaltopk(opcional): Número máximo de resultados (1-100, por defecto 20)return_doc_keys(opcional): Campos de retorno especificadosauto_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ítuloabstract: Resumenauthors: Lista de autoresdoi: DOIpmid: ID de PubMedlink: Enlacepublication: Publicaciónpub_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
-
Reinicie Claude Desktop después de configurar la clave API
-
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超能文献
- Plugin de Zotero: https://github.com/WildDataX/suppr-zotero-plugin
- Sitio web oficial: https://suppr.wilddata.cn
- Traducción de documentos con IA: https://suppr.wilddata.cn/translate/upload
- Servicio API: https://openapi.suppr.wilddata.cn/introduction
- Búsqueda de PubMed en chino: https://suppr.wilddata.cn/
- Investigación profunda: https://suppr.wilddata.cn/deep-research
- Organización de GitHub: WildDataX
Soporte técnico
Para obtener ayuda, contacte: IT@wilddata.cn
Hecho con ❤️ por WildData
Ecosistema Suppr
| Producto | Enlace |
|---|---|
| 🌐 Plataforma Suppr | suppr.wilddata.cn |
| 📖 Documentación de la API | openapi.suppr.wilddata.cn |
| 🔌 Plugin de Zotero | suppr-zotero-plugin |
| 🤖 Habilidades de Claude Code | suppr-skills |
| 🔬 Investigación profunda | suppr.wilddata.cn/deep-research |
| 📄 Traducción con IA | suppr.wilddata.cn/translate/upload |
| 🔎 Búsqueda en PubMed | suppr.wilddata.cn |