STARWARCLOUD STARWAR.AI
返回市场
支持-mcp

支持-mcp

作者：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桌面

  1. 配置API密钥后重启Claude桌面

  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 超能力文献产品

技术支持

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

由 WildData 制作 ❤️