支持-mcp

Name: 支持-mcp
Author: WildDataX

作者：WildDataX88 星标更新：2025-10-28

安装使用来源：spider==github.com

项目介绍

Suppr MCP - 使用指南 | 提供文档翻译服务及中文PubMed文献搜索 | Suppr 超能力文献

快速开始

1. 安装

全局安装：

npm install -g suppr-mcp

或者使用NPX（无需安装）：

npx suppr-mcp

2. 获取API密钥

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

3. 配置环境变量

export SUPPR_API_KEY=your_api_key_here

4. 在MCP客户端中使用

Claude桌面配置

编辑 ~/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. creat_translation - 创建翻译任务

创建一个文档翻译任务。

参数

file_path（选择file_cath或file_url）：源文件路径
file_url（选择file_cath或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": "0_2a6c6d1-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_decuments - 文献搜索

基于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作者列表
doiDOI
pmidPubMed 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
}

常见错误：

四百零一API密钥无效或未提供
四百请求参数错误
四百零四资源不存在

使用示例

使用Claude桌面

配置API密钥后重启Claude桌面
在对话中使用工具：

翻译文档：

请帮我翻译这份文档：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 超能力文献产品

Zotero插件：https://github.com/WildDataX/suppr-zotero-plugin
官方网站：https://suppr.wilddata.cn
AI文档翻译：https://suppr.wilddata.cn/translate/upload
API服务：https://openapi.suppr.wilddata.cn/introduction
中文PubMed文献搜索：https://suppr.wilddata.cn/
深入研究：https://suppr.wilddata.cn/deep-research
GitHub组织：WildDataX

技术支持

如有需要帮助，请联系：IT@wilddata.cn

由 WildData 制作 ❤️