Scopus について
Scopusは、Elsevier Scopusのデータを検索するMCPサーバーです。研究や計量書誌のワークフロー向けに、検索、プロフィール、引用、PlumXのツールを提供し、API本来のJSON項目を返します。
主な機能
- 01出版物・著者・所属機関の検索
- 02著者と機関のプロフィール取得
- 03年別の引用概要取得
- 04PlumX指標の検索
- 05APIのJSONをそのまま返却
活用シーン
- 01出版物や共著者の検索
- 02著者または機関のプロフィール確認
- 03年別引用数の確認
- 04出版物指標の取得
MCP 対応
Elsevier Scopus APIの操作を、出版物検索、プロフィール取得、引用データ、PlumX指標などのツールとしてMCPクライアントに提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y scopus-mcpELSEVIER_API_KEYシークレットElsevier API key from https://dev.elsevier.com. Required for every tool except subject_classifications; data access depends on your subscription and institutional access.ELSEVIER_INST_TOKENシークレットInstitutional token supplied by Elsevier, if available for your institution. Used alongside the API key for institutional access.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
8掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| ver | string | いいえ | リソースのバージョンフラグ:facetexpand、allexpand、new。カンマまたはセミコロンで区切ります。 |
| date | string | いいえ | 出版年または両端を含む年の範囲。例:2024 または 2020-2024。 |
| sort | string | いいえ | カンマ区切りで最大 3 つのソートフィールドを指定します。+ は昇順、- は降順です。例:-coverDate,+creator。 |
| subj | string | いいえ | 絞り込みに使用する Scopus の分野コード。例:COMP。 |
| view | any | いいえ | レスポンスのビューです。デフォルトは STANDARD です。COMPLETE と COMPONENT には該当する Scopus の利用資格が必要です。field を指定すると、この設定は上書きされます。 |
| alias | boolean | いいえ | 著者 ID 検索に置き換え済みのプロフィールを含めるかどうかです。省略時は API のデフォルト値 true が使われます。 |
| count | integer | いいえ | このページの最大結果数です。デフォルトは 25 です。STANDARD では最大 200、COMPLETE/COMPONENT では最大 25 です。field を指定すると、実際のビューと上限は Elsevier が決定します。 |
| field | string | いいえ | カンマ区切りのレスポンスフィールド。例:identifier,title,doi。view より優先されます。省略したフィールドはレスポンスに含まれません。 |
| query | string | はい | Scopus のネイティブな出版物クエリ。例:TITLE-ABS-KEY(machine learning) AND PUBYEAR > 2020。 |
| reqId | string | いいえ | Elsevier サポート用に呼び出し元が指定するリクエスト識別子です。 |
| start | integer | いいえ | 0 始まりの結果オフセットです。cursor の代わりに使用します。要求ウィンドウの開始位置 + count は 5000 を超えてはなりません。count を省略すると 25 になります。 |
| cursor | string | いいえ | 最初のカーソルページには * を使用し、その後は前のレスポンスの search-results.cursor["@next"] を使用します。start の代わりに使用し、クエリと他のオプションは変更しないでください。 |
| facets | string | いいえ | ネイティブのファセット式。例:pubyear;subjarea(count=10,sort=fd)。 |
| content | any | いいえ | 検索する Scopus コンテンツコレクション:all、core、または dummy。 |
| suppressNavLinks | boolean | いいえ | トップレベルのナビゲーションリンクを抑制します。省略時は API のデフォルト値 false が使われます。 |
詳細
scopus-mcp
Elsevier Scopus API 用の MCP サーバーです。npx を使って stdio 経由で実行し、
API のパラメーター名と JSON レスポンスをそのまま保持します。
クイックスタート
Node.js 22.22.0 以降、npm、および stdio 対応の MCP クライアントが必要です。 Elsevier Developer Portal から API キーを取得し、 このサーバーをクライアントの設定に追加します。
{
"mcpServers": {
"scopus": {
"command": "npx",
"args": ["-y", "scopus-mcp"],
"env": {
"ELSEVIER_API_KEY": "your-elsevier-api-key"
}
}
}
}
接続するには、クライアントを再読み込みします。リリースを固定するには、args で
scopus-mcp@<version> を使用します。
設定
| 環境変数 | 説明 |
|---|---|
ELSEVIER_API_KEY | subject_classifications を除くすべてのツールで必須です。 |
ELSEVIER_INST_TOKEN | 所属機関から提供されている場合に使用する機関トークンです。 |
クライアントの env オブジェクトで認証情報を設定します。このサーバーは .env
ファイルを読み込みません。データやビューへのアクセスは、Elsevier のサブスクリプションと
機関経由のアクセス権によって異なります。
サーバーは MCP の serverInfo と stderr の起動ログにバージョンを出力します。
ツール
| ツール | 説明 |
|---|---|
| scopus_search | 出版物を検索します。 |
| author_search | 著者と共著者を検索します。 |
| affiliation_search | 機関を検索します。 |
| author_retrieval | ID、EID、または ORCID で著者プロフィールを取得します。 |
| affiliation_retrieval | ID または EID で機関プロフィールを取得します。 |
| citation_overview | 年ごとの引用数と概要を取得します。 |
| plumx_metrics | 識別子で出版物のメトリクスを取得します。 |
| subject_classifications | 分野コードを参照します。API キーは不要です。 |
各呼び出しで API リクエストを 1 回実行します。追加のページを取得するには、ツールのページネーション パラメーターを使用します。リクエストはキャンセルと 30 秒のタイムアウトに対応しています。再試行と リダイレクトは自動では行われません。
レスポンスとエラー
結果は各ツールの outputSchema に従います。元の API JSON は、フィールドの形を変更したり
値を変換したりせず、structuredContent とテキストコンテンツブロックの両方で返されます。
利用可能なクォータヘッダーは、_meta["scopus-mcp/headers"] に文字列として返されます:
X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset、Retry-After。
API エラーの場合は、isError: true と、code、message、および利用可能な場合は HTTP
status を含む JSON テキストエラーが返されます。認証情報はマスキングされます。無効な引数は、
API リクエストの前に拒否されます。
| エラー | 確認事項 |
|---|---|
MISSING_API_KEY | サーバーの環境に ELSEVIER_API_KEY を設定してください。 |
| HTTP 401 または 403 | キー、サブスクリプション、機関ネットワーク、トークンを確認してください。 |
| HTTP 429 | 再試行する前に、クォータヘッダーと Retry-After を確認してください。 |
TIMEOUT または NETWORK_ERROR | api.elsevier.com への接続を確認してください。 |
INVALID_RESPONSE | Elsevier が無効な JSON、または想定外のレスポンス形式を返しました。 |
API ドキュメント
開発
ローカルでのセットアップと変更についてはコントリビューションを、公開についてはリリースをご覧ください。
ライセンス
MIT © 2026 Andrii Baran。独立したプロジェクトであり、Elsevier とは提携していません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。