Yuzongmin Semantic Scholar Fastmcp MCP Server

🚀 セマンティックスカラー MCP サーバー

このサーバーは、Semantic Scholar API 用の高速な MCP サーバー実装です。学術論文データ、著者情報、引用ネットワークへの全面的なアクセスを提供します。

✨ 主な機能

論文検索と発見

• 全文検索と高度なフィルタリング機能を備えています。
• タイトルでの論文検索が可能です。
• 論文推薦（単一および複数）機能があります。
• 論文詳細の一括取得ができます。
• 高度な検索とソート戦略を組み合わせた機能があります。

引用分析

• 引用ネットワークの探索が可能です。
• 参考文献の追跡ができます。
• 引用文脈と影響力の分析ができます。

著者情報

• 著者検索とプロファイル照会ができます。
• 発表履歴の閲覧ができます。
• 著者詳細の一括取得ができます。

高度な機能

• 複数のソート戦略を組み合わせた複雑な検索が可能です。
• カスタマイズ可能なフィールド選択ができます。
• 効率的なバッチ処理操作ができます。
• 規格に準拠したレート制限戦略があります。
• 認証および非認証アクセスをサポートしています。
• スムーズなシャットダウンとエラー処理ができます。
• 接続プールとリソース管理が行われます。

📦 インストール

システム要件

• Python 3.8+
• FastMCP フレームワーク
• APIキー環境変数（オプション）

インストール手順

FastMCP を使用してインストールします：

fastmcp install semantic-scholar-server.py --name "Semantic Scholar" -e SEMANTIC_SCHOLAR_API_KEY=your-api-key

-e SEMANTIC_SCHOLAR_API_KEY パラメータはオプションです。提供されない場合、サーバーは非認証アクセスを使用し、より低いレート制限が適用されます。

📚 ドキュメント

設定

環境変数

• SEMANTIC_SCHOLAR_API_KEY: あなたの Semantic Scholar API キー（オプション）
  • Semantic Scholar API でキーを取得できます。
  • 提供されない場合、サーバーは非認証アクセスを使用します。

レート制限戦略

サーバーは自動的に適切なレート制限に調整されます：

APIキー付きの場合：

• 検索、バッチ、推薦エンドポイント：毎秒1回のリクエスト
• その他のエンドポイント：毎秒10回のリクエスト

キーがない場合：

• すべてのエンドポイント：5分間で100回のリクエスト
• リクエストのタイムアウト時間が長くなります。

利用可能な MCP ツール

⚠️ 重要な注意

すべてのツールは公式の Semantic Scholar API ドキュメント と一致しています。詳細なフィールド説明やその他の情報については、公式ドキュメントを参照してください。

エラー処理

サーバーは標準的なエラーレスポンスを提供します：

{
    "error": {
        "type": "error_type",  # 考えられるエラータイプ：レート制限、APIエラー、認証失敗、タイムアウトなど
        "message": "エラーの説明",
        "details": {
            # 追加のコンテキスト
            "authenticated": true/false  # リクエストが認証されたかどうかを示す
        }
    }
}