Yuzongmin Semantic Scholar Fastmcp MCP Server

🚀 語義學者 MCP 服務器

語義學者 MCP 服務器是一個快速的 MCP 服務器實現，專為 Semantic Scholar API 打造。它能讓用戶全面訪問學術論文數據、作者信息以及引文網絡，為學術研究提供強大支持。

✨ 主要特性

論文搜索與發現

• 具備全文搜索和高級篩選功能，可精準定位所需論文。
• 支持標題匹配論文查找，快速找到目標論文。
• 提供論文推薦（單篇和多篇）服務，助力發現更多相關論文。
• 支持批量獲取論文詳情，提高信息獲取效率。
• 高級搜索結合排序策略，讓搜索結果更符合需求。

引文分析

• 支持引文網絡探索，深入瞭解論文間的引用關係。
• 可進行參考文獻追蹤，追溯論文的源頭。
• 提供引文上下文與影響力分析，評估論文的學術價值。

作者信息

• 支持作者搜索和資料查詢，輕鬆獲取作者詳細信息。
• 可查看作者的發表歷史，瞭解其學術成果。
• 支持批量獲取作者詳情，提高信息收集效率。

高級功能

• 支持多排序策略結合的複雜搜索，滿足多樣化的搜索需求。
• 可自定義字段選擇，靈活獲取所需信息。
• 具備高效批處理操作，提升數據處理效率。
• 採用符合規範的限流策略，保障系統穩定運行。
• 支持認證和非認證訪問，滿足不同用戶的使用場景。
• 具備平滑關閉與錯誤處理機制，確保系統的可靠性。
• 實現連接池與資源管理，優化系統資源利用。

📦 安裝指南

系統要求

• 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  # 表示請求是否經過認證
        }
    }
}