Semantic Scholar API MCP server について
Semantic Scholar API で論文を検索する MCP サーバーで、mcp Python SDK を用いて構築されています。Claude や Cline 上で文献調査を行う研究者に適しています。API キーを設定すると、リクエスト上限を引き上げられます。
主な機能
- 01Semantic Scholar による論文検索
- 02レート制限緩和のための API キー設定
- 03mcp dev と mcp install による実行
- 04Claude と Cline 向けの設定
活用シーン
- 01AI アシスタント内での文献調査の補助
- 02事前調査用エージェントの論文検索ツールとしての利用
MCP 対応
本プロジェクトは MCP サーバーで、Semantic Scholar の論文検索機能を Claude や Cline などの MCP クライアントに提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Semantic Scholar API MCP サーバー
mcp-python-sdk で作成
重要
この MCP サーバーの FastMCP 版をまだ使用している場合は、このリポジトリを再度プルして新しいバージョンに更新することをおすすめします。FastMCP はすでに非推奨になっています。
使用方法
必要条件:pip install -r requirements.txt
mcp dev path/to/semantic-scholar-plugin.py を実行してサーバーを初期化します。
mcp install path/to/semantic-scholar-plugin.py を実行して Claude にインストールするか、次の設定を claude/cline の設定に追加します。
"semantic-scholar": {
"command": "uv",
"args": [
"run",
"--with",
"mcp",
"mcp",
"run",
"/path/to/semantic-scholar-plugin.py"
]
}
メモ
現在、
uvとmcpを使用すると、一部の Linux/macOS 版 Claude-desktop で問題が発生するようです。次のように設定する必要がある場合があります。"semantic-scholar": { "command": "/path/to/mcp", "args": [ "run", "/path/to/semantic-scholar-plugin.py" ] }代わりに、ターミナルで
which mcpを実行して取得した/path/to/mcpを使用します。
API キー
Semantic Scholar API をより高いレート制限で使用するには、API キーを環境変数として設定します。
export SEMANTIC_SCHOLAR_API_KEY="your_api_key"
または、mcp の設定に env キーを追加して設定します。
"semantic-scholar": {
"command": ...,
"args": ...,
"env": {
"SEMANTIC_SCHOLAR_API_KEY": "your_api_key"
}
}
API キーは、https://www.semanticscholar.org/product/api のフォームに入力すると取得できます。
推奨エージェントシステムプロンプト
benhaotang/my_agent_system_prompt をご覧ください。この AI 事前調査エージェントは、この MCP サーバーを最大限に活用できます。
既知の問題
- cline で
INFO Processing request of type __init__.py:431 ListToolsRequestのようなメッセージが表示されても、動作には影響しないため無視してかまいません。これは、cline がツール一覧とコンソールのデバッグ情報をまとめて解析するためです。また、現在の python-sdk ではコンソールメッセージを無効にできません。この警告が表示されること以外、関数呼び出しには影響しません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。