Scholar Search MCP

Claude、Cursor、その他のMCPクライアントで学術文献ワークフローを実現するためのMCPサーバーです。

Semantic Scholar + arXivを単一のツールセットに統合し、高速な並列検索、正規化された出力、ソースを意識した重複排除、および実用的な研究ユーティリティ（引用、参考文献、著者グラフ、推奨論文、arXivソースのダウンロード）を提供します。

目次

• 本プロジェクトの目的

• デモ動画

• インストール

• クイックセットアップ (Claude Desktop / Cursor)

• 環境変数

• ツール一覧

• MCP Inspectorによるテスト

• 貢献

• ライセンス

Related MCP server: arXiv Research Assistant MCP Server

本プロジェクトの目的

ほとんどの論文ツールでは、単一のソースやAPIスタイルを選択せざるを得ません。scholar-search-mcpは、文献検索とグラフ取得のための単一のMCPレイヤーを提供します。

• 1つのMCPサーバーで、複数の学術ソースに対応

• 無料利用を優先したデフォルト設定（arXivはキーなしで動作）

• LLMフレンドリーな出力（後続の推論やエージェントワークフロー向け）

• 検索だけでなく、実用的な研究アクションを提供

• 統合検索: search_papersはSemantic ScholarとarXivを並列実行し、正規化されたタイトルで重複を排除します。

• 研究グラフツール: 詳細、引用、参考文献、著者プロフィール/論文、推奨論文の取得。

• バッチ + ソースワークフロー: 最大500件の論文を取得し、arXivのLaTeXソースをダウンロード/抽出可能。

• 運用制御: キャッシュ機能と環境変数によるソースの切り替え（チャンネルの有効化/無効化）。

• ソース戦略: Semantic ScholarとarXivを内蔵。デフォルトで無料利用を優先（arXivはキー不要）、Semantic Scholarの制限を緩和するためのオプションのAPIキーにも対応。

デモ動画

エージェントがScholar Search MCPを使用してサーベイ論文を作成する様子。

インストール

pip install scholar-search-mcp

Python 3.10以上が必要です。

クイックセットアップ (Claude Desktop / Cursor)

両方のクライアントで同じサーバーコマンドを使用します：

{
  "mcpServers": {
    "scholar-search": {
      "command": "python",
      "args": ["-m", "scholar_search_mcp"],
      "env": {
        "SCHOLAR_SEARCH_ENABLE_SEMANTIC_SCHOLAR": "true",
        "SCHOLAR_SEARCH_ENABLE_ARXIV": "true"
      }
    }
  }
}

SEMANTIC_SCHOLAR_API_KEYはオプションです。Semantic Scholarのレート制限を緩和したい場合のみ追加してください：

{
  "mcpServers": {
    "scholar-search": {
      "command": "python",
      "args": ["-m", "scholar_search_mcp"],
      "env": {
        "SCHOLAR_SEARCH_ENABLE_SEMANTIC_SCHOLAR": "true",
        "SCHOLAR_SEARCH_ENABLE_ARXIV": "true",
        "SEMANTIC_SCHOLAR_API_KEY": "your-key"
      }
    }
  }
}

違い：

• Claude Desktop: ローカルの設定ファイルを直接編集します。

• Cursor: Cursorの設定UI（または対応する設定JSON）にMCPサーバーを追加します。

Claude Desktopの設定ファイルの場所：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

環境変数

例（arXivのみ）：

{
  "SCHOLAR_SEARCH_ENABLE_SEMANTIC_SCHOLAR": "false",
  "SCHOLAR_SEARCH_ENABLE_ARXIV": "true"
}

ツール一覧

MCP Inspectorによるテスト

npm install -g @modelcontextprotocol/inspector
mcp-inspector python -m scholar_search_mcp

貢献

IssueやPRを歓迎します。リポジトリをフォークし、ブランチを作成し、検証/テストを追加した上で、変更前後の動作を明確にしたPRを作成してください。

ライセンス

MIT

参考文献

• Semantic Scholar API Docs

• arXiv API User Manual