Paper Search MCP

🚀 論文搜索 MCP 服務

paper-search-mcp 是一個基於 Python 的 MCP 服務器，可讓用戶從多個平臺搜索和下載學術論文。它提供搜索和下載工具，適合研究人員和 AI 驅動的工作流，還能與 LLM 客戶端如 Claude Desktop 平滑集成。

🚀 快速開始

使用 Smithery 快速安裝

通過 Smithery 快速安裝：

# 在終端運行以下命令：
uv add @openags/paper-search-mcp

這將自動下載並安裝 paper-search-mcp 以及所有依賴項。

啟動服務

1. 初始化 MCP 服務：

from paper_search_mcp import PaperSearchMCP
server = PaperSearchMCP()

2. 啟動服務器：

uv run your_project_name

3. 使用 API 搜索論文：

curl http://localhost:5000/api/search?q=quantum+computing

4. 下載 PDF：

curl -o paper.pdf http://localhost:5000/api/download/1234

配置 Claude Desktop

要將 paper-search-mcp 與 Claude Desktop 集成，請按照以下步驟操作：

1. 在 Claude 中配置 MCP 代理：

proxies:
  paper_search_mcp:
    type: http
    url: http://localhost:5000

2. 使用 Claude 調用論文搜索功能：

from claude import Claude
claire = Claude(license_key)
response = claire(
    "搜索關於量子計算的最新論文。",
    tools=[PaperSearchMCP Tool]
)

✨ 主要特性

• 多來源支持：從 arXiv、PubMed、bioRxiv 和 Sci-Hub（可選）搜索和下載論文。
• 標準化輸出：通過 Paper 類返回一致的字典格式。
• 異步工具：使用 httpx 有效地處理網絡請求。
• MCP 集成：與 MCP 客戶端兼容，以增強 LLM 上下文。
• 可擴展設計：通過擴展 academic_platforms 模塊輕鬆添加新的學術平臺。

📦 安裝指南

paper-search-mcp 可以使用 uv 或 pip 安裝。下面有兩種方法：快速開始立即使用和詳細的開發安裝。

使用 Smithery 快速安裝

通過 Smithery 快速安裝：

# 在終端運行以下命令：
uv add @openags/paper-search-mcp

這將自動下載並安裝 paper-search-mcp 以及所有依賴項。

使用 pip 安裝

如果無法使用 Smithery，可以手動安裝：

1. 克隆存儲庫：

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

2. 安裝依賴項：

pip install -r requirements.txt

3. 安裝包：

python setup.py install

開發用途

1. 克隆存儲庫：

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

2. 創建虛擬環境並安裝依賴項：

python -m venv venv
source venv/bin/activate  # 在 Windows 上使用 `venv\Scripts\activate`
pip install -r requirements.txt

3. 運行測試：

pytest tests/

🤝 貢獻

歡迎貢獻！請按照以下步驟提交代碼：

1. Fork 倉庫並在您的分支上進行更改。
2. 提交併推送更改。
3. 創建 Pull Request 到主分支。

如何添加新平臺

要添加新的學術平臺，請按照以下步驟操作：

1. 在 academic_platforms/ 文件夾中創建一個新的模塊。
2. 實現搜索和下載功能。
3. 更新測試用例。
4. 提交到倉庫。

📋 待辦事項

計劃中的學術平臺

• [√] arXiv
• [√] PubMed
• [√] bioRxiv
• [√] medRxiv
• [√] Google Scholar
• [ ] Semantic Scholar
• [ ] PubMed Central (PMC)
• [ ] Science Direct
• [ ] Springer Link
• [ ] IEEE Xplore
• [ ] ACM Digital Library
• [ ] Web of Science
• [ ] Scopus
• [ ] JSTOR
• [ ] ResearchGate
• [ ] CORE
• [ ] Microsoft Academic

📄 許可證

此項目在 MIT 許可證下分發。有關詳細信息，請參閱 LICENSE 文件。

使用 paper-search-mcp 進行愉快的研究！如果遇到問題，請在 GitHub 上打開一個問題。