Academic Paper Search

🚀 學術論文搜索 MCP 服務器

本項目是一個基於 Model Context Protocol (MCP) 的服務器，支持從多個來源搜索和檢索學術論文信息。它為大型語言模型（LLMs）提供即時學術論文搜索、論文元數據和摘要訪問、獲取可用全文內容等功能，並以符合 MCP 規範的結構化數據進行響應。雖然主要針對與 Anthropic 的 Claude 桌面客戶端集成設計，但也能與其他支持工具/功能調用能力的 AI 模型和客戶端兼容。

⚠️ 重要提示

此軟件處於積極開發階段，功能和特性可能會發生變化。

🚀 快速開始

安裝

本服務器提供了兩種安裝方式，可根據需求選擇：

使用 Smithery

通過以下命令安裝並運行服務器：

smithery install @afrise/academic-search-mcp-server
smithery run

手動安裝（使用 uv）

1. 克隆倉庫：

git clone https://github.com/yourusername/academic-paper-search.git

2. 安裝依賴項：

cd academic-paper-search
pip install -r requirements.txt

3. 設置環境變量（如果需要身份驗證）：

export API_KEY=your_api_key_here

4. 啟動服務器：

python server.py

使用

在 Claude 桌面客戶端中配置服務器：

1. 打開設置，導航到插件部分。
2. 添加以下 JSON 配置：

{
    "server_url": "http://localhost:8000",
    "api_key": "your_api_key_here"
}

✨ 主要特性

該服務器暴露了以下實用工具：

search_papers

在多個來源中搜索學術論文。

• 參數：
  • query (str)：搜索查詢文本。
  • limit (int, 可選)：結果的最大數量（默認值：10）。
• 返回：包含論文詳細信息的格式化字符串。

fetch_paper_details

檢索特定論文的詳細信息。

• 參數：
  • paper_id (str)：論文標識符（DOI 或 Semantic Scholar ID）。
  • source (str, 可選)：數據源 ("crossref" 或 "semantic_scholar", 默認值： "crossref")。
• 返回：包含全面論文元數據的格式化字符串，包括標題、作者、年份、DOI、標題、摘要等。

search_by_topic

按主題搜索論文。

• 參數：
  • topic (str)：搜索的主題或關鍵詞。
  • year_range (tuple, 可選)：年份範圍（例如 (2015, 2023)）。
  • language (str, 可選)：論文語言（例如 "English"、"Chinese" 等）。
• 返回：包含匹配論文標題和摘要的列表。

🔧 技術細節

項目使用技術

• Python MCP SDK：提供 MCP 協議支持。
• FastMCP：高性能的 MCP 服務器框架。
• httpx：異步 HTTP 客戶端和服務器。

API 來源

• Semantic Scholar API：提供高質量的學術論文數據。
• Crossref API：獲取出版物元數據。

📄 許可證

該項目採用 AGPL - 3.0 協議，具體內容請參閱 LICENSE 文件。

🤝 貢獻指南

歡迎大家參與項目貢獻，以下是參與方式：

1. Fork 倉庫：

git clone https://github.com/yourusername/academic-paper-search.git

2. 創建功能分支：

git checkout -b feature/amazing-feature

3. 提交更改：

git commit -m 'Add amazing feature'

4. 推送到分支：

git push origin feature/amazing-feature

5. 提交 Pull Request

注意事項

• 遵循現有的代碼風格和約定。
• 為新功能添加測試。
• 更新相關文檔。
• 確保更改符合 AGPL - 3.0 許可證條款。

通過參與此項目，您同意您的貢獻將根據 AGPL - 3.0 許可證發佈。