Suppr MCP - 利用ガイド | ドキュメント翻訳およびPubMed検索用MCPサービス | Suppr超能文献

Suppr MCP Server

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 クライアントで動作します。

インストール

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: 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 の翻訳進捗を確認して

よくある質問

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

Made with ❤️ by WildData

Supprエコシステム