scopus-mcp

Scopus MCP サーバー

中文 | English

💡 このツールとのチャット方法については、Interaction Guide & Prompt Examplesをご覧ください！

Elsevier Scopus API へのアクセスを提供する Model Context Protocol（MCP）サーバーです。AI アシスタントが学術論文を検索したり、要約を取得したり、著者のプロフィールを調べたりできます。

Elsevier Scopus API キーの申請には、通常、所属する組織または機関が Elsevier のデータベースサービスを購読している必要があります。また、手動でセットアップせずにこのツールを実行するには、お使いのデバイスに uv パッケージマネージャーがインストールされている必要があります。

設定

セットアップ手順

1. Elsevier Developer Portalにアクセスして、API キーを申請します。
2. プロジェクトのルートに config.json ファイルを作成するか、config.json.exampleからコピーし、キーを入力します。

   {
     "api_key": "YOUR_KEY_HERE"
   }
   

3. MCP_tool_config.jsonを編集し、フォルダーのパスを変更します（スラッシュの向きに注意してください）。
4. 最後に、MCP_tool_config.jsonの内容をコピーして、MCP クライアント（Claude Desktop など）に設定をインポートします。

🚀 クイックスタート（セットアップ不要）

前提条件：uvがインストールされている必要があります。

• Windows：powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
• macOS/Linux：curl -LsSf https://astral.sh/uv/install.sh | sh

Claude Desktop を使用している場合は、コードをダウンロードせずに、直接設定できます。

1. キーを取得：Elsevier Developer Portalから無料の API キーを取得します。（⚠️ 注：教育機関または組織のメールアドレスを推奨します。一般向けメールドメインは拒否される場合があります。）
2. 設定：%APPDATA%\Claude\claude_desktop_config.json（Windows）または ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）を編集します。
3. 追加：

{
  "mcpServers": {
    "scopus-assistant": {
      "command": "uvx",
      "args": [
        "scopus-mcp"
      ],
      "env": {
        "SCOPUS_API_KEY": "PUT_YOUR_KEY_HERE"
      }
    }
  }
}

（uvがない場合は、手動でセットアップする方法についてインストールをご覧ください）

Trae での使用

Trae の「Settings」→「MCP Servers」に移動し、Addをクリックして、**Manual Configuration (JSON)**を選択し、次の内容を貼り付けます。

{
  "mcpServers": {
    "scopus-assistant": {
      "command": "uvx",
      "args": [
        "scopus-mcp"
      ],
      "env": {
        "SCOPUS_API_KEY": "PUT_YOUR_KEY_HERE"
      }
    }
  }
}

Cursor での使用

1. Cursor Settings → Features → MCP Serversを開きます。
2. + Add New MCP Serverをクリックします。
3. 詳細を入力します。
   • Name：scopus-mcp
   • Type：command（stdio）
   • Command：uvx scopus-mcp
4. 重要：システム環境変数にSCOPUS_API_KEYを設定する必要があります。

インストール

1. Python 3.10+がインストールされていることを確認します。
2. 依存関係をインストールします。

   pip install .
   

使用方法

サーバーの実行

uvx（推奨）を使うか、Python で直接サーバーを実行できます。

# Using uvx
uvx --from . scopus-mcp

# Or directly
python -m scopus_mcp.server

利用可能なツール

1. search_scopus

   • 標準的なクエリ構文を使用して Scopus データベースを検索します。
   • 引数：
     • query（string）：検索クエリ（例：TITLE("Artificial Intelligence")）。
     • count（integer）：返す結果の件数（デフォルト：5）。
     • sort（string）：並べ替え順（例：coverDate）。

2. get_abstract_details

   • 指定した文書の詳細情報を取得します。
   • 引数：
     • scopus_id（string）：文書の Scopus ID。

3. get_author_profile

   • 著者のプロフィール情報を取得します。
   • 引数：
     • author_id（string）：Scopus Author ID。

開発

次のコマンドでテストを実行します。

pytest

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細はLICENSEファイルをご覧ください。

謝辞と貢献者

• thinktraveller - 初期作業およびコア開発
• qwe4559999 - メンテナー