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

Suppr MCP - 使用ガイド | 文書翻訳と中国語でのPubMed検索を提供するMCPサービス | Suppr超能文献

Suppr MCP サーバー

Suppr（超能文献）は、WildDataが提供するAI搭載の学術ツールプラットフォームです。このMCPサーバーは、AIアシスタントに文書翻訳と文献検索の機能を提供します。

🌐 AI文書翻訳 — PDF、Word（.docx）、Excel（.xlsx）、PowerPoint（.pptx）、TXT、HTML文書を13言語間で翻訳できます。元の書式を維持し、原文の言語を自動検出します。

🔬 PubMed学術検索 — 数百万件の生物医学研究論文から、意味に基づいて文献を検索します。DOI、PMID、ジャーナルインパクトファクター、引用数、著者の所属、要旨、論文への直接リンクなど、構造化されたメタデータを返します。

🤖 MCP互換 — Claude Desktop、Cursor、Windsurf、およびあらゆるModel Context Protocolクライアントで動作します。

インストール

```bash npx suppr-mcp ```

クイックスタート

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（任意）: 1ページあたりの件数。デフォルトは 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: 英語
• zh: 中国語
• ko: 韓国語
• ja: 日本語
• fr: フランス語
• de: ドイツ語
• es: スペイン語
• ru: ロシア語
• ar: アラビア語
• pt: ポルトガル語
• it: イタリア語
• 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超能文献产品

• 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

技术支持

如需帮助，请联系：[email protected]

Made with ❤️ by WildData

Suppr Ecosystem

Product	Link
🌐 Suppr Platform	suppr.wilddata.cn
📖 API Documentation	openapi.suppr.wilddata.cn
🔌 Zotero Plugin	suppr-zotero-plugin
🤖 Claude Code Skills	suppr-skills
🔬 Deep Research	suppr.wilddata.cn/deep-research
📄 AI Translation	suppr.wilddata.cn/translate/upload
🔎 PubMed Search	suppr.wilddata.cn