Suppr MCP

🚀 Suppr MCP - 使用指南 | 提供文檔翻譯及中文搜Pubmed的MCP服務 | Suppr超能文獻

Suppr MCP服務可提供文檔翻譯和中文搜索Pubmed文獻的功能，幫助用戶更高效地處理文獻資料，提升信息獲取和處理效率。

🚀 快速開始

安裝

• 全局安裝：

npm install -g suppr-mcp

• 使用 npx（無需安裝）：

npx suppr-mcp

獲取 API Key

訪問 Suppr API 獲取您的 API 密鑰。

配置環境變量

export SUPPR_API_KEY=your_api_key_here

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

✨ 主要特性

可用工具

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
}

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：錯誤

list_translations - 列出翻譯任務

獲取翻譯任務列表，支持分頁。

• 參數：
  • offset (可選)：分頁偏移量，默認 0
  • limit (可選)：每頁數量，默認 20
• 示例：

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

• 返回：

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

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 的翻譯進度

🔗 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

Made with ❤️ by WildData