Suppr-MCP (超能文献)

Serviço de tradução de documentos e busca acadêmica com inteligência artificial. Suporta tradução de alta qualidade nos formatos PDF, DOCX, PPTX e outros, em 11 idiomas, com tratamento otimizado de fórmulas matemáticas. Inclui busca inteligente de literatura integrada ao PubMed para pesquisadores. https://suppr.wilddata.cn/

GitHub

255

Experimente este MCPPatrocinado

Documentação

Suppr MCP - Guia de Uso | Serviço MCP de tradução de documentos e busca PubMed em chinês | Suppr超能文献

Servidor Suppr MCP

Suppr (超能文献) é uma plataforma de ferramentas acadêmicas com IA da WildData. Este servidor MCP traz capacidades de tradução de documentos e busca de literatura para assistentes de IA.

🌐 Tradução de Documentos com IA — Traduza documentos PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), TXT e HTML em 13 idiomas. Preserva a formatação original. Detecção automática do idioma de origem.

🔬 Busca Acadêmica PubMed — Descoberta semântica de literatura em milhões de artigos de pesquisa biomédica. Retorna metadados estruturados: DOI, PMID, fator de impacto do periódico, contagem de citações, afiliações de autores, resumos e links diretos para os artigos.

🤖 Compatível com MCP — Funciona com Claude Desktop, Cursor, Windsurf e qualquer cliente Model Context Protocol.

Instalação

\`bash npx suppr-mcp \`

Início Rápido

1. Instalação

Instalação global:

npm install -g suppr-mcp

Ou use npx (sem instalação):

npx suppr-mcp

2. Obtenha sua API Key

Acesse Suppr API para obter sua chave de API.

3. Configure as variáveis de ambiente

export SUPPR_API_KEY=your_api_key_here

4. Use no cliente MCP

Configuração do Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou o arquivo de configuração correspondente:

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

Ou use a instalação global:

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

Ferramentas Disponíveis

1. create_translation - Criar tarefa de tradução

Cria uma tarefa de tradução de documento.

Parâmetros:

file_path (file_path ou file_url, escolha um): caminho do arquivo de origem
file_url (file_path ou file_url, escolha um): URL do documento a ser traduzido
to_lang (obrigatório): código do idioma de destino
from_lang (opcional): código do idioma de origem (detecção automática por padrão)
optimize_math_formula (opcional): otimizar fórmulas matemáticas (apenas PDF)

Exemplo:

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

Retorno:

{
  "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 - Obter detalhes da tradução

Obtém informações detalhadas e o status da tarefa de tradução.

Parâmetros:

task_id (obrigatório): ID da tarefa de tradução

Exemplo:

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

Retorno:

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

Descrição dos status da tarefa:

INIT: inicializado
PROGRESS: em andamento
DONE: concluído
ERROR: erro

3. list_translations - Listar tarefas de tradução

Obtém a lista de tarefas de tradução, com suporte a paginação.

Parâmetros:

offset (opcional): deslocamento de paginação, padrão 0
limit (opcional): quantidade por página, padrão 20

Exemplo:

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

Retorno:

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

4. search_documents - Busca de literatura

Busca semântica de literatura com IA.

Parâmetros:

query (obrigatório): consulta em linguagem natural
topk (opcional): quantidade máxima de resultados (1-100, padrão 20)
return_doc_keys (opcional): campos de retorno especificados
auto_select (opcional): selecionar automaticamente o melhor resultado (padrão true)

Exemplo:

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

Campos de retorno disponíveis:

title: título
abstract: resumo
authors: lista de autores
doi: DOI
pmid: ID PubMed
link: link
publication: publicação
pub_year: ano de publicação
Mais campos na documentação da API

Retorno:

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

Idiomas Suportados

Códigos de idioma comuns:

en: English (inglês)
zh: Chinese (chinês)
ko: Korean (coreano)
ja: Japanese (japonês)
fr: French (francês)
de: German (alemão)
es: Spanish (espanhol)
ru: Russian (russo)
ar: Arabic (árabe)
pt: Portuguese (português)
it: Italian (italiano)
auto: detecção automática

Tratamento de Erros

Todos os erros retornam um formato padrão:

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

Erros comuns:

401: Chave de API inválida ou não fornecida
400: Erro nos parâmetros da requisição
404: Recurso não encontrado

Exemplos de Uso

No Claude Desktop

Após configurar a chave de API, reinicie o Claude Desktop
Use as ferramentas na conversa:

Traduzir documento:

Por favor, traduza este documento: https://example.com/paper.pdf, traduza para o inglês

Buscar literatura:

Busque os artigos mais recentes sobre "aplicações de aprendizado profundo em imagens médicas"

Consultar status da tradução:

Verifique o progresso da tradução da tarefa 02a6c6d1-3f70-4a5a-80bc-971d53a37bb1

Perguntas Frequentes

P: Como obter uma chave de API?

R: Acesse https://suppr.wilddata.cn/api-keys para se registrar e obter sua chave de API.

P: Quais formatos de documento são suportados?

R: Suporta formatos comuns como PDF, DOCX, PPTX, XLSX, HTML, TXT, EPUB, etc.

P: Quanto tempo leva a tradução?

R: Depende do tamanho do documento, geralmente de alguns minutos a cerca de quinze minutos. Você pode usar get_translation para consultar o progresso.

P: Como baixar o documento traduzido?

R: Após a conclusão da tradução, get_translation retornará target_file_url, basta acessar esse link para baixar.

P: O npx falha ao executar?

R: Certifique-se de que a versão do Node.js seja >= 18.0.0 e que a variável de ambiente SUPPR_API_KEY esteja configurada.

🔗 Produtos Suppr超能文献

Plugin Zotero: https://github.com/WildDataX/suppr-zotero-plugin
Site oficial: https://suppr.wilddata.cn
Tradução de documentos com IA: https://suppr.wilddata.cn/translate/upload
Serviço de API: https://openapi.suppr.wilddata.cn/introduction
Busca PubMed em chinês: https://suppr.wilddata.cn/
Pesquisa aprofundada: https://suppr.wilddata.cn/deep-research
Organização GitHub: WildDataX

Suporte Técnico

Para obter ajuda, entre em contato: IT@wilddata.cn

Feito com ❤️ por WildData

Ecossistema Suppr

Produto	Link
🌐 Plataforma Suppr	suppr.wilddata.cn
📖 Documentação da API	openapi.suppr.wilddata.cn
🔌 Plugin Zotero	suppr-zotero-plugin
🤖 Claude Code Skills	suppr-skills
🔬 Pesquisa Aprofundada	suppr.wilddata.cn/deep-research
📄 Tradução com IA	suppr.wilddata.cn/translate/upload
🔎 Busca PubMed	suppr.wilddata.cn