Scholar Sidekick Mcp

Scholar Sidekick MCP Server

Scholar Sidekick のための MCP サーバーです。あらゆる AI アシスタントから、AI が捏造した引用を一件ずつ、または参考文献リスト全体を対象に検出できます。また、撤回状況とオープンアクセス状況を確認し、あらゆる学術識別子（DOI、PMID、PMCID、ISBN、arXiv、ISSN、NASA ADS bibcode、WHO IRIS URL）を10,000以上のCSLスタイルまたは9種類のエクスポート形式に変換できます。

主な機能

• 引用の捏造検出 — verifyCitation は、申告された引用と識別子から解決されたレコードを照合し、単純な識別子解決では検出できない、Topaz et al.（Lancet 2026） が報告した、AIによる支配的な捏造パターン「実在するDOI＋創作されたタイトル」を検出します。詳しい解説は scholar-sidekick.com/citation-integrity をご覧ください。
• 参考文献リスト全体の監査 — auditBibliography は、同じ照合と撤回情報の検索を参考文献リスト全体に対して1回の呼び出しで実行します。BibTeX、RIS、CSL JSONを受け取り、各項目の判定表とコーパスの概要を返します。
• 撤回とオープンアクセスの確認 — checkRetraction は撤回、訂正、懸念表明（Crossref／Retraction Watch）を表示し、checkOpenAccess はOA状況と最適な合法的なランディングページまたはPDFのURL（Unpaywall）を返します。どちらもあらゆる種類の識別子を受け付け、内部でDOIに解決します。
• 標準で8種類の識別子に対応 — DOI、PMID、PMCID、ISBN、arXiv ID、ISSN、NASA ADS bibcode、WHO IRIS URL（引用ツールでは珍しい形式）。
• バッチ処理に対応した解決／書式設定／エクスポート — それぞれ単一の識別子、またはカンマ区切りか改行区切りのリストを受け付けます。サーバーがリストを正規化し、1回の往復で解決します。
• 10,000以上の引用スタイル — 手動で調整された5種類の組み込みスタイル（Vancouver、AMA、APA、IEEE、CSE）に加え、任意のCSLスタイルIDに対応し、別名と従属スタイルも解決します。
• 9種類のエクスポート形式 — BibTeX、RIS、CSL JSON、EndNote（XML/Refer）、RefWorks、MEDLINE、Zotero RDF、CSV、プレーンテキスト。
• 組み合わせ可能なワークフロー — 1つのプロンプト内で resolveIdentifier → formatCitation → exportCitation とつなげることで、「未加工のIDからエクスポート可能な参考文献リストまで」を一貫して処理できます。
• すべての応答に出所メタデータを付与 — 書式設定された出力の後にメタデータブロック（requestId、formatter、styleUsed、warnings）が続くため、アシスタントは各引用の生成にどのエンジンを使用したかをユーザーに示せます。
• キー不要 — 公開 Scholar Sidekick API を匿名で利用できます（無料枠にはレート制限があります）。上限を引き上げるには無料のファーストパーティ ssk_ キーを追加するか、有料／管理対象プランには RapidAPI キーを使用してください。
• ホスト型HTTPエンドポイント（インストール不要） — ローカルのstdioサーバーを実行したくない場合は、HTTP対応のMCPクライアントから https://scholar-sidekick.com/api/mcp に直接接続できます（Streamable HTTP、同じ7つのツール）。ホスト型HTTPエンドポイントをご覧ください。
• REST API版も利用可能 — 同じエンドポイントを、MCP以外の連携向けに Scholar Sidekick REST API としても利用できます。

ツール

ツール	説明
verifyCitation	主張された引用を、識別子で解決されたレコードと照合して検証します。resolveIdentifier だけでは検出できない、Topaz et al.（Lancet 2026）の捏造パターン（実在する DOI と架空のタイトルの組み合わせ）を検出します。4 種類の判定（matched／mismatch／ambiguous／not_found）に加え、フィールドごとの類似度スコアと解決されたレコードを返すため、引用されたタイトルと実際の論文がどこで食い違っているかを確認できます。オプションの Stage 3 LLM スクリーニングでは、略称の非公式な表記による誤検出を回避します（有料プラン／ファーストパーティ認証のみ）。1 回の呼び出しにつき引用は 1 件です。
auditBibliography	1 回の呼び出しで、文献目録全体に対して verifyCitation による確認と撤回情報の検索を実行します。BibTeX、RIS、CSL-JSON の生テキスト、または事前に解析された claims[] 配列を受け付け、エントリーごとの判定表とコーパスの概要を返します。1 回の呼び出しにつき最大 25 件です。
resolveIdentifier	DOI、PMID、PMCID、ISBN、arXiv ID、ISSN、ADS bibcode、WHO IRIS URL を、構造化された書誌メタデータ（CSL JSON）に解決します。単一の識別子、またはカンマ／改行区切りの一括入力を受け付けます。
formatCitation	1 件または複数の識別子を、Vancouver、AMA、APA、IEEE、CSE、または 10,000 種類以上の CSL スタイルで書式設定します。テキスト、HTML、JSON で出力します。書式設定された引用と、出典情報のメタデータブロックを返します。
exportCitation	1 件または複数の識別子を、BibTeX、RIS、CSL JSON、EndNote（XML/Refer）、RefWorks、MEDLINE、Zotero RDF、CSV、またはプレーンテキストにエクスポートします。ディスクへの書き込みや文献管理ツールへの取り込みにそのまま使えます。
checkRetraction	1 件の著作物が撤回済みか、訂正済みか、または懸念表明が出されているかを確認します。Crossref の updated-by（Retraction Watch）を情報源とします。検索前に DOI／PMID／PMCID／arXiv／ADS の入力を DOI に解決します。1 回の呼び出しにつき識別子は 1 件です。
checkOpenAccess	1 件の著作物がオープンアクセスで利用できるか、また最適な合法版をどこで見つけられるかを確認します。Unpaywall を情報源とします。OA ステータス（gold／green／hybrid／bronze／closed）、最適なランディングページ／PDF の URL、ライセンス、バージョンを返します。検索前に DOI／PMID／PMCID／arXiv／ISBN／ADS の入力を DOI に解決します。1 回の呼び出しにつき識別子は 1 件です。

7 つのツールはすべて読み取り専用です（readOnlyHint: true、destructiveHint: false）。正確な tools/list ペイロード（説明、JSON Schema、アノテーション）は tools.json としてコミットされ、npm tarball に含まれているため、実行せずに ツールの全容を確認できます。

セットアップ

キーは不要です。 サーバーは公開 Scholar Sidekick API （https://scholar-sidekick.com）に匿名で接続し、レート制限付きの無料枠で動作します。インストールするだけですぐに使えます。上限を引き上げるには、 scholar-sidekick.com/account で無料のファーストパーティ ssk_ キーを作成し、SCHOLAR_API_KEY を設定してください。 有料／管理対象のプランを利用する場合は、 RapidAPI で登録し、 RAPIDAPI_KEY を設定してください（呼び出しは RapidAPI ゲートウェイ経由でルーティングされます）。

インストールせずに使いたい場合は？ ホスト型 HTTP エンドポイント（Streamable HTTP）https://scholar-sidekick.com/api/mcp もあります。HTTP 対応の MCP クライアントを直接接続でき、npx は不要です。ホスト型 HTTP エンドポイント（インストール不要） をご覧ください。ここで説明する stdio パッケージは、ローカルインストールの代替手段です（RapidAPI キーを使用する場合の方法でもあります）。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。キーも env ブロックも不要です。

{
  "mcpServers": {
    "scholar-sidekick": {
      "command": "npx",
      "args": ["-y", "scholar-sidekick-mcp@latest"]
    }
  }
}

レート制限を引き上げたい場合のみ、 scholar-sidekick.com/account の無料の ssk_ キーを使って env ブロックを追加します。

"env": { "SCHOLAR_API_KEY": "ssk_your-first-party-key" }

Claude Code

# Anonymous (no key):
claude mcp add scholar-sidekick -- npx -y scholar-sidekick-mcp@latest

# With a free first-party key for higher limits:
claude mcp add scholar-sidekick \
  -e SCHOLAR_API_KEY=ssk_your-first-party-key \
  -- npx -y scholar-sidekick-mcp@latest

Claude Code プラグイン（サーバーとスキルを一度に導入）

このリポジトリはClaude Code プラグインマーケットプレイスでもあります。プラグインをインストールすると、MCP サーバーと関連するエージェントスキルがまとめて設定されます。claude mcp add も env ブロックも不要です。

/plugin marketplace add mlava/scholar-sidekick-mcp
/plugin install scholar-sidekick@scholar-sidekick

このプラグインはサーバーを匿名で実行します（キー不要）。レート制限を緩和するには、無料の ssk_ キーを scholar-sidekick.com/account から取得して、上記のように claude mcp add で追加するか、以下のホスト型エンドポイントを使用してください。

Cursor / VS Code / Windsurf

.cursor/mcp.json または .vscode/mcp.json に追加します。キーは不要です。

{
  "mcpServers": {
    "scholar-sidekick": {
      "command": "npx",
      "args": ["-y", "scholar-sidekick-mcp@latest"]
    }
  }
}

レート制限を緩和するには、"env": { "SCHOLAR_API_KEY": "ssk_your-first-party-key" } を追加してください。

コンテナーで実行する（サンドボックス化）

このサーバーは stdio 経由で MCP を通信し、Scholar Sidekick API へのアウトバウンド HTTPS 接続のみを必要とします。ファイルシステムやシェルへのアクセスは不要です。MCP サーバーにホストへのアクセスを許可しないポリシーの場合は、このリポジトリでイメージをビルドし、隔離して実行してください。

docker build -t scholar-sidekick-mcp .

{
  "mcpServers": {
    "scholar-sidekick": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "--read-only", "--cap-drop", "ALL", "--security-opt", "no-new-privileges",
        "scholar-sidekick-mcp"
      ]
    }
  }
}

-i は必須です。これは stdio のパイプです。レート制限の緩和にキーを渡す場合にのみ、引数に "-e", "SCHOLAR_API_KEY", を追加してください。 レジストリにはイメージを公開していません。ソースを確認できる状態で、自分でビルドしたバンドルを実行できるよう、ローカルでビルドしてください。

エージェントスキル（任意）

関連するエージェントスキルをインストールすると、Claude Code、Cline、その他のエージェントが、これらのツールをいつ、どのように使うかを習得できます。このスキルは、上記のサーバー設定を補完します。

npx skills add mlava/scholar-sidekick-mcp

ホスト型 HTTP エンドポイント（インストール不要）

ローカルの stdio サーバーを実行したくない場合、Scholar Sidekick は https://scholar-sidekick.com/api/mcp でホスト型 Streamable HTTP MCPも提供しています。7 つのツールを利用でき、npx もローカルプロセスも不要です。匿名で利用でき（レート制限付きの無料プラン）、レート制限を緩和するには、Authorization: Bearer ssk_… ヘッダーを追加してください（無料キーは scholar-sidekick.com/account から取得できます）。

HTTP 対応の MCP クライアントから接続してください。

{
  "mcpServers": {
    "scholar-sidekick": {
      "type": "http",
      "url": "https://scholar-sidekick.com/api/mcp"
    }
  }
}

Claude Desktop では、Settings → Connectors → Add custom connector（または「Add HTTP server」）を選び、URL を貼り付けてください。キーをお持ちの場合は、クライアントのヘッダー／認証欄にベアラートークンを追加してください。

ディスカバリー用の /.well-known/mcp.json（SEP-1649 サーバーカード）には、このエンドポイントと、認証不要の ChatGPT Apps エンドポイント /api/apps/mcp が記載されています。上記の stdio パッケージは、引き続きローカルインストールの代替手段であり、RapidAPI キーを使用するユーザー向けの方法でもあります。

環境変数

変数	必須	説明
SCHOLAR_API_KEY	いいえ	scholar-sidekick.com/account で取得できる無料のファーストパーティ ssk_ キーです。レート制限を緩和し、検証ツールの LLM スクリーニングを有効にします。Authorization: Bearer として送信されます。
RAPIDAPI_KEY	いいえ	有料／マネージドプラン用の RapidAPI サブスクリプションキーです。設定すると、呼び出しは RapidAPI ゲートウェイ経由でルーティングされます。
RAPIDAPI_HOST	いいえ	RapidAPI ホストです（デフォルトは scholar-sidekick.p.rapidapi.com）。
SCHOLAR_SIDEKICK_URL	いいえ	API のベース URL を上書きします（デフォルトは https://scholar-sidekick.com。RAPIDAPI_KEY が設定されている場合は RapidAPI ゲートウェイです）。
SCHOLAR_SIDEKICK_TIMEOUT_MS	いいえ	リクエストのタイムアウト（ミリ秒）です（デフォルト：30000）。

キーを設定しない場合は、匿名のレート制限付き無料プランになります。SCHOLAR_API_KEY と RAPIDAPI_KEY の両方を設定した場合は、RapidAPI が優先されます。

対応する引用スタイル

Scholar Sidekick は、学術出版で使われる主要な形式をすべて含む、10,000 種類以上の CSL スタイルに対応しています。

スタイル	キーワード
Vancouver	vancouver
APA（第 7 版）	apa
AMA	ama
IEEE	ieee
CSE	cse
Chicago（著者・日付方式）	chicago-author-date
Harvard	harvard-cite-them-right
MLA	modern-language-association
Turabian	turabian-fullnote-bibliography
Nature	nature
BMJ	bmj
Lancet	the-lancet

任意の CSL スタイル ID を style パラメーターとして渡せます。

使用例

接続したら、AI アシスタントに次のように尋ねます。

単一の識別子

• 「10.1056/NEJMoa2033700 をバンクーバー方式で整形して」
• 「PMID:30049270 を解決して、BibTeX としてエクスポートして」
• 「arXiv:2301.08745 のシカゴ方式の引用を作成して」

一括入力（カンマ区切りまたは改行区切り — すべてのツールで処理できます）

• 「次の項目を APA 方式で整形して：10.1056/NEJMoa2033700, PMID:30049270, ISBN:9780192854087」
• 「次の項目をすべて解決して、雑誌論文と書籍のどちらかを教えて：10.1056/NEJMoa2033700, ISBN:9780192854087, PMC7793608」

エンドツーエンドのワークフロー（アシスタントが1つのプロンプト内で resolveIdentifier → formatCitation → exportCitation を連続して実行します）

• 「次の3つの識別子を解決し、それぞれを AMA 方式で整形して、まとめて BibTeX としてエクスポートして：10.1056/NEJMoa2033700, PMID:30049270, ISBN:9780192854087」
• 「このリストから Nature 方式の参考文献一覧を作成して、最後に .bib ファイルを渡して：PMID:30049270, arXiv:2301.08745, 10.1038/s41586-021-03819-2」

撤回とオープンアクセスの確認（1回の呼び出しにつき識別子は1つ）

• 「10.1016/S0140-6736(20)31180-6 は撤回されていますか？」→ 撤回通知と日付を含む isRetracted: true を返します
• 「NumPy の論文（10.1038/s41586-020-2649-2）はオープンアクセスですか？無料で読める場所はどこですか？」→ OA 状況に加え、ライセンスとバージョンを含む最適な合法 PDF URL を返します
• 「arXiv:2301.08745 に訂正や懸念表明があるか確認して」→ arXiv → DOI を解決してから Retraction Watch に問い合わせます

対応する識別子

• DOI（例：10.1056/NEJMoa2033700）
• PubMed ID（例：PMID:30049270）
• PubMed Central ID（例：PMC7793608）
• ISBN（例：ISBN:9780192854087）
• arXiv ID（例：2301.08745）
• ISSN および eISSN
• NASA ADS の書誌コード
• WHO IRIS の URL

来歴と決定性

すべての formatCitation および exportCitation の応答にはメタデータブロックが続きます。これにより、アシスタントとユーザーは、それぞれの引用をどのエンジンが生成したかを正確に確認できます。

• formatter — builtin（バンクーバー、AMA、APA、IEEE、CSE のいずれか。TypeScript で手動調整）または csl（CSL スタイルシートを使用する citeproc-js）。
• styleUsed — エイリアスと従属スタイルの解決後の正規スタイル ID（例：harvard を指定すると harvard-cite-them-right に解決されます）。
• requestId — サポート、再現性、ログの照合に使用します。
• warnings — フォールバックが使用された場合、または要求したスタイルが別のスタイルに従属している場合に値が設定されます。

同じ入力と固定された上流メタデータを使用すれば、識別子の解決結果は決定的です。同じリクエストを繰り返すと、基盤となる REST API のキャッシュにヒットし、その旨が x-scholar-cache ヘッダーに示されます。

REST API

MCP クライアント以外からプログラムでアクセスする場合も、同じ機能を scholar-sidekick.com の REST API で利用できます。匿名での利用、無料のファーストパーティ ssk_ キー（Authorization: Bearer）を使った利用、または有料プラン向けの RapidAPI 経由での利用が可能です。ここで使用する認証情報は、そちらでも使用できます。

開発

npm install
npm run build    # Bundle to dist/mcp-server.mjs
npm test         # Run tests
npm run typecheck

ライセンス

MIT