Skip to content
Back to search

suppr-mcp

超能文献|AI驱动的文档翻译与学术搜索服务。支持PDF、DOCX、PPTX等多格式文档的高质量翻译(支持11种语言),特别优化了数学公式翻译。同时提供PubMed学术文献智能搜索功能。更多访问:https://suppr.wilddata.cn

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/wilddatax--suppr-mcp/badge.svg)](/listings/wilddatax--suppr-mcp)

HTML

<a href="/listings/wilddatax--suppr-mcp"><img src="/api/listings/wilddatax--suppr-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

\`\`\`bash npx suppr-mcp \`\`\`

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 331 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Suppr MCP - Usage Guide | 提供文档翻译及中文搜Pubmed的MCP服务 | Suppr超能文献
  2. # Suppr MCP Server
  3. > **[Suppr](https://suppr.wilddata.cn)** (超能文献) is an AI-powered academic tools platform by [WildData](https://wilddata.cn). This MCP server brings document translation and literature search capabilities to AI assistants.
  4. 🌐 **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.
  5. 🔬 **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.
  6. 🤖 **MCP Compatible** — Works with Claude Desktop, Cursor, Windsurf, and any [Model Context Protocol](https://modelcontextprotocol.io) client.
  7. [![npm version](https://img.shields.io/npm/v/suppr-mcp)](https://www.npmjs.com/package/suppr-mcp)
  8. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  9. ## Install
  10. \`\`\`bash
  11. npx suppr-mcp
  12. \`\`\`
  13. ## Quick Start
  14. ### 1. 安装
  15. 全局安装:
  16. ```bash
  17. npm install -g suppr-mcp
  18. ```
  19. 或者使用 npx(无需安装):
  20. ```bash
  21. npx suppr-mcp
  22. ```
  23. ### 2. 获取 API Key
  24. 访问 [Suppr API](https://suppr.wilddata.cn/api-keys) 获取您的 API 密钥。
  25. ### 3. 配置环境变量
  26. ```bash
  27. export SUPPR_API_KEY=your_api_key_here
  28. ```
  29. ### 4. 在 MCP 客户端中使用
  30. #### Claude Desktop 配置
  31. 编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`(macOS)或相应配置文件:
  32. ```json
  33. {
  34. "mcpServers": {
  35. "suppr": {
  36. "command": "npx",
  37. "args": ["-y", "suppr-mcp"],
  38. "env": {
  39. "SUPPR_API_KEY": "your_api_key_here"
  40. }
  41. }
  42. }
  43. }
  44. ```
  45. 或者使用全局安装:
  46. ```json
  47. {
  48. "mcpServers": {
  49. "suppr": {
  50. "command": "suppr-mcp",
  51. "env": {
  52. "SUPPR_API_KEY": "your_api_key_here"
  53. }
  54. }
  55. }
  56. }
  57. ```
  58. ## 可用工具
  59. ### 1. create_translation - 创建翻译任务
  60. 创建文档翻译任务。
  61. **参数:**
  62. - `file_path` (file_path 和 file_url 二选一): 源文件路径
  63. - `file_url` (file_path 和 file_url 二选一): 要翻译的文档 URL
  64. - `to_lang` (必填): 目标语言代码
  65. - `from_lang` (可选): 源语言代码(默认自动检测)
  66. - `optimize_math_formula` (可选): 优化数学公式(仅 PDF)
  67. **示例:**
  68. ```json
  69. {
  70. "file_url": "https://example.com/document.pdf",
  71. "to_lang": "en",
  72. "from_lang": "zh",
  73. "optimize_math_formula": true
  74. }
  75. ```
  76. **返回:**
  77. ```json
  78. {
  79. "task_id": "02a6c6d1-3f70-4a5a-80bc-971d53a37bb1",
  80. "status": "INIT",
  81. "consumed_point": 453,
  82. "source_lang": "zh",
  83. "target_lang": "en",
  84. "optimize_math_formula": true
  85. }
  86. ```
  87. ### 2. get_translation - 获取翻译详情
  88. 获取翻译任务的详细信息和状态。
  89. **参数:**
  90. - `task_id` (必填): 翻译任务 ID
  91. **示例:**
  92. ```json
  93. {
  94. "task_id": "02a6c6d1-3f70-4a5a-80bc-971d53a37bb1"
  95. }
  96. ```
  97. **返回:**
  98. ```json
  99. {
  100. "task_id": "02a6c6d1-3f70-4a5a-80bc-971d53a37bb1",
  101. "status": "DONE",
  102. "progress": 1.0,
  103. "consumed_point": 453,
  104. "source_file_name": "document.pdf",
  105. "source_file_url": "https://example.com/source.pdf",
  106. "target_file_url": "https://example.com/translated.pdf",
  107. "source_lang": "zh",
  108. "target_lang": "en",
  109. "error_msg": null,
  110. "optimize_math_formula": true
  111. }
  112. ```
  113. **任务状态说明:**
  114. - `INIT`: 初始化
  115. - `PROGRESS`: 进行中
  116. - `DONE`: 已完成
  117. - `ERROR`: 错误
  118. ### 3. list_translations - 列出翻译任务
  119. 获取翻译任务列表,支持分页。
  120. **参数:**
  121. - `offset` (可选): 分页偏移量,默认 0
  122. - `limit` (可选): 每页数量,默认 20
  123. **示例:**
  124. ```json
  125. {
  126. "offset": 0,
  127. "limit": 10
  128. }
  129. ```
  130. **返回:**
  131. ```json
  132. {
  133. "total": 42,
  134. "offset": 0,
  135. "limit": 10,
  136. "list": [
  137. {
  138. "task_id": "...",
  139. "status": "DONE",
  140. "progress": 1.0,
  141. ...
  142. }
  143. ]
  144. }
  145. ```
  146. ### 4. search_documents - 文献搜索
  147. AI 驱动的文献语义搜索。
  148. **参数:**
  149. - `query` (必填): 自然语言查询
  150. - `topk` (可选): 最大返回数量(1-100,默认 20)
  151. - `return_doc_keys` (可选): 指定返回字段
  152. - `auto_select` (可选): 自动选择最优结果(默认 true)
  153. **示例:**
  154. ```json
  155. {
  156. "query": "糖尿病最新研究进展",
  157. "topk": 5,
  158. "return_doc_keys": ["title", "abstract", "doi", "authors"],
  159. "auto_select": true
  160. }
  161. ```
  162. **可用的返回字段:**
  163. - `title`: 标题
  164. - `abstract`: 摘要
  165. - `authors`: 作者列表
  166. - `doi`: DOI
  167. - `pmid`: PubMed ID
  168. - `link`: 链接
  169. - `publication`: 出版物
  170. - `pub_year`: 出版年份
  171. - 更多字段请参考 API 文档
  172. **返回:**
  173. ```json
  174. {
  175. "search_items": [
  176. {
  177. "doc": {
  178. "title": "...",
  179. "abstract": "...",
  180. "authors": [...],
  181. "doi": "...",
  182. ...
  183. },
  184. "search_gateway": "pubmed"
  185. }
  186. ],
  187. "consumed_points": 20
  188. }
  189. ```
  190. ## 支持的语言
  191. 常用语言代码:
  192. - `en`: English (英语)
  193. - `zh`: Chinese (中文)
  194. - `ko`: Korean (韩语)
  195. - `ja`: Japanese (日语)
  196. - `fr`: French (法语)
  197. - `de`: German (德语)
  198. - `es`: Spanish (西班牙语)
  199. - `ru`: Russian (俄语)
  200. - `ar`: Arabic (阿拉伯语)
  201. - `pt`: Portuguese (葡萄牙语)
  202. - `it`: Italian (意大利语)
  203. - `auto`: 自动检测
  204. ## 错误处理
  205. 所有错误都会返回标准格式:
  206. ```json
  207. {
  208. "code": 非零错误码,
  209. "msg": "错误信息",
  210. "data": null
  211. }
  212. ```
  213. 常见错误:
  214. - **401**: API 密钥无效或未提供
  215. - **400**: 请求参数错误
  216. - **404**: 资源不存在
  217. ## 使用示例
  218. ### 在 Claude Desktop 中使用
  219. 1. 配置好 API 密钥后重启 Claude Desktop
  220. 2. 在对话中使用工具:
  221. **翻译文档:**
  222. > 请帮我翻译这个文档:https://example.com/paper.pdf,翻译成英文
  223. **搜索文献:**
  224. > 帮我搜索关于"深度学习在医学影像中的应用"的最新文献
  225. **查询翻译状态:**
  226. > 查看任务 02a6c6d1-3f70-4a5a-80bc-971d53a37bb1 的翻译进度
  227. ## 常见问题
  228. ### Q: 如何获取 API 密钥?
  229. A: 访问 https://suppr.wilddata.cn/api-keys 注册并获取 API 密钥。
  230. ### Q: 支持哪些文档格式?
  231. A: 支持 PDF, DOCX, PPTX, XLSX, HTML, TXT, EPUB等常见格式。
  232. ### Q: 翻译需要多长时间?
  233. A: 取决于文档大小,通常几分钟到十几分钟不等。可以使用 `get_translation` 查询进度。
  234. ### Q: 如何下载翻译后的文档?
  235. A: 翻译完成后,`get_translation` 会返回 `target_file_url`,直接访问该链接下载。
  236. ### Q: npx 运行失败?
  237. A: 确保 Node.js 版本 >= 18.0.0,并且设置了 SUPPR_API_KEY 环境变量。
  238. ## 🔗 Suppr超能文献产品
  239. - **Zotero插件** : https://github.com/WildDataX/suppr-zotero-plugin
  240. - **官方网站**:[https://suppr.wilddata.cn](https://suppr.wilddata.cn)
  241. - **AI文档翻译**:https://suppr.wilddata.cn/translate/upload
  242. - **API服务**:https://openapi.suppr.wilddata.cn/introduction
  243. - **中文搜Pubmed**: https://suppr.wilddata.cn/
  244. - **深度研究**:[https://suppr.wilddata.cn/deep-research](https://suppr.wilddata.cn/deep-research)
  245. - **GitHub组织**:[WildDataX](https://github.com/WildDataX)
  246. ## 技术支持
  247. 如需帮助,请联系:IT@wilddata.cn
  248. Made with ❤️ by [WildData](https://wilddata.cn)
  249. ## Suppr Ecosystem
  250. | Product | Link |
  251. |---------|------|
  252. | 🌐 Suppr Platform | [suppr.wilddata.cn](https://suppr.wilddata.cn) |
  253. | 📖 API Documentation | [openapi.suppr.wilddata.cn](https://openapi.suppr.wilddata.cn/introduction.html) |
  254. | 🔌 Zotero Plugin | [suppr-zotero-plugin](https://github.com/WildDataX/suppr-zotero-plugin) |
  255. | 🤖 Claude Code Skills | [suppr-skills](https://github.com/WildDataX/suppr-skills) |
  256. | 🔬 Deep Research | [suppr.wilddata.cn/deep-research](https://suppr.wilddata.cn/deep-research) |
  257. | 📄 AI Translation | [suppr.wilddata.cn/translate/upload](https://suppr.wilddata.cn/translate/upload) |
  258. | 🔎 PubMed Search | [suppr.wilddata.cn](https://suppr.wilddata.cn/) |

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.