Suppr MCP

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

このプロジェクトは、文書翻訳と中国語での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
• GitHub組織：WildDataX

📄 技術サポート

サポートが必要な場合は、IT@wilddata.cnまでご連絡ください。

❤️ by WildData