mcpField
超
超能文献MCP(AI文档翻译+文献检索)

超能文献MCP(AI文档翻译+文献检索)

本地服务
github.com/WildDataX搜索与检索25729 周前更新

关于 超能文献MCP(AI文档翻译+文献检索)

超能文献的 MCP 服务面向学术研究者和 AI 助手,提供文档翻译与 PubMed 文献语义检索。翻译支持多种常见文档格式,并保留原格式;检索结果包含 DOI、摘要等文献信息。

主要功能

  1. 01多格式文档翻译
  2. 02支持 13 种语言
  3. 03保留文档原格式
  4. 04PubMed 语义检索
  5. 05查询翻译任务进度

适用场景

  1. 01翻译 PDF 或 Office 学术文档
  2. 02用自然语言查找生物医学文献
  3. 03查看翻译任务状态

MCP 相关

作为 MCP 服务,它向兼容的 MCP 客户端提供文档翻译任务管理和 PubMed 文献搜索工具。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"suppr": {
"command": "npx",
"args": [
"-y",
"suppr-mcp"
],
"env": {
"SUPPR_API_KEY": "<SUPPR_API_KEY>"
}
}
}
}
启动命令npx -y suppr-mcp
需要配置的环境变量
SUPPR_API_KEY密钥

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmsuppr-mcp

工具

4

收录的工具列表 · 更新于 2 周前

参数类型必填说明
file_pathstring否要翻译的本地文件路径(不能与 file_url 同时使用)
file_urlstring否要翻译的文档 URL(不能与 file_path 同时使用)
from_langstring否源语言代码(可选;未指定时自动检测)
optimize_math_formulaboolean否优化数学公式(仅限 PDF)
to_langstring是目标语言代码(必填),例如:en、zh、ko、ja

详细介绍

来自项目 README

Suppr MCP - Usage Guide | 提供文档翻译及中文搜Pubmed的MCP服务 | Suppr超能文献

Suppr MCP Server

Suppr (超能文献) is an AI-powered academic tools platform by WildData. This MCP server brings document translation and literature search capabilities to AI assistants.

🌐 AI Document Translation — Translate PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), TXT, and HTML documents across 13 languages. Preserves original formatting. Automatic source language detection.

🔬 PubMed Academic Search — Semantic literature discovery across millions of biomedical research papers. Returns structured metadata: DOI, PMID, journal impact factor, citation counts, author affiliations, abstracts, and direct paper links.

🤖 MCP Compatible — Works with Claude Desktop, Cursor, Windsurf, and any Model Context Protocol client.

npm version License: MIT

Install

```bash npx suppr-mcp ```

Quick Start

1. 安装

全局安装:

npm install -g suppr-mcp

或者使用 npx(无需安装):

npx suppr-mcp
2. 获取 API Key

访问 Suppr API 获取您的 API 密钥。

3. 配置环境变量
export SUPPR_API_KEY=your_api_key_here
4. 在 MCP 客户端中使用
Claude Desktop 配置

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json(macOS)或相应配置文件:

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

或者使用全局安装:

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

可用工具

1. create_translation - 创建翻译任务

创建文档翻译任务。

参数:

  • file_path (file_path 和 file_url 二选一): 源文件路径
  • file_url (file_path 和 file_url 二选一): 要翻译的文档 URL
  • to_lang (必填): 目标语言代码
  • from_lang (可选): 源语言代码(默认自动检测)
  • optimize_math_formula (可选): 优化数学公式(仅 PDF)

示例:

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

返回:

{
  "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 - 获取翻译详情

获取翻译任务的详细信息和状态。

参数:

  • task_id (必填): 翻译任务 ID

示例:

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

返回:

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

任务状态说明:

  • INIT: 初始化
  • PROGRESS: 进行中
  • DONE: 已完成
  • ERROR: 错误
3. list_translations - 列出翻译任务

获取翻译任务列表,支持分页。

参数:

  • offset (可选): 分页偏移量,默认 0
  • limit (可选): 每页数量,默认 20

示例:

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

返回:

{
  "total": 42,
  "offset": 0,
  "limit": 10,
  "list": [
    {
      "task_id": "...",
      "status": "DONE",
      "progress": 1.0,
      ...
    }
  ]
}
4. search_documents - 文献搜索

AI 驱动的文献语义搜索。

参数:

  • query (必填): 自然语言查询
  • topk (可选): 最大返回数量(1-100,默认 20)
  • return_doc_keys (可选): 指定返回字段
  • auto_select (可选): 自动选择最优结果(默认 true)

示例:

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

可用的返回字段:

  • title: 标题
  • abstract: 摘要
  • authors: 作者列表
  • doi: DOI
  • pmid: PubMed ID
  • link: 链接
  • publication: 出版物
  • pub_year: 出版年份
  • 更多字段请参考 API 文档

返回:

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

支持的语言

常用语言代码:

  • en: English (英语)
  • zh: Chinese (中文)
  • ko: Korean (韩语)
  • ja: Japanese (日语)
  • fr: French (法语)
  • de: German (德语)
  • es: Spanish (西班牙语)
  • ru: Russian (俄语)
  • ar: Arabic (阿拉伯语)
  • pt: Portuguese (葡萄牙语)
  • it: Italian (意大利语)
  • auto: 自动检测

错误处理

所有错误都会返回标准格式:

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

常见错误:

  • 401: API 密钥无效或未提供
  • 400: 请求参数错误
  • 404: 资源不存在

使用示例

在 Claude Desktop 中使用
  1. 配置好 API 密钥后重启 Claude Desktop

  2. 在对话中使用工具:

翻译文档:

请帮我翻译这个文档:https://example.com/paper.pdf,翻译成英文

搜索文献:

帮我搜索关于"深度学习在医学影像中的应用"的最新文献

查询翻译状态:

查看任务 02a6c6d1-3f70-4a5a-80bc-971d53a37bb1 的翻译进度

常见问题

Q: 如何获取 API 密钥?

A: 访问 https://suppr.wilddata.cn/api-keys 注册并获取 API 密钥。

Q: 支持哪些文档格式?

A: 支持 PDF, DOCX, PPTX, XLSX, HTML, TXT, EPUB等常见格式。

Q: 翻译需要多长时间?

A: 取决于文档大小,通常几分钟到十几分钟不等。可以使用 get_translation 查询进度。

Q: 如何下载翻译后的文档?

A: 翻译完成后,get_translation 会返回 target_file_url,直接访问该链接下载。

Q: npx 运行失败?

A: 确保 Node.js 版本 >= 18.0.0,并且设置了 SUPPR_API_KEY 环境变量。

🔗 Suppr超能文献产品

技术支持

如需帮助,请联系:[email protected]

Made with ❤️ by WildData

Suppr Ecosystem

ProductLink
🌐 Suppr Platformsuppr.wilddata.cn
📖 API Documentationopenapi.suppr.wilddata.cn
🔌 Zotero Pluginsuppr-zotero-plugin
🤖 Claude Code Skillssuppr-skills
🔬 Deep Researchsuppr.wilddata.cn/deep-research
📄 AI Translationsuppr.wilddata.cn/translate/upload
🔎 PubMed Searchsuppr.wilddata.cn

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。