Suppr MCP

🚀 Suppr MCP - 使用ガイド | 文書翻訳と中国語でのPubmed検索のMCPサービスを提供 | 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 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](https://suppr.wilddata.cn/deep - research)
• GitHub組織：WildDataX

🔧 技術サポート

ヘルプが必要な場合は、IT@wilddata.cnまでご連絡ください。

❤️ by WildData