Academia MCP

🚀 Academia MCP

Academia MCP 是一個 MCP 服務器，提供了搜索、獲取、分析科學論文和數據集並生成報告的工具，能有效助力科研工作。

🚀 快速開始

運行方式

• 通過 HTTP 運行（默認傳輸方式）：

python -m academia_mcp --transport streamable-http
# 或者
uv run -m academia_mcp --transport streamable-http

• 通過標準輸入輸出運行（適用於像 Claude Desktop 這樣的本地 MCP 客戶端）：

python -m academia_mcp --transport stdio
# 或者
uv run -m academia_mcp --transport stdio

注意事項：

• 支持的傳輸方式有：stdio、sse、streamable-http。
• host/port 用於 HTTP 傳輸方式；在 stdio 傳輸方式中會被忽略。默認端口是 5056（或者使用 PORT 環境變量指定）。

Claude Desktop 配置

{
  "mcpServers": {
    "academia": {
      "command": "python3",
      "args": [
        "-m",
        "academia_mcp",
        "--transport",
        "stdio"
      ]
    }
  }
}

✨ 主要特性

• 學術資源搜索與下載：支持 ArXiv 搜索和下載、ACL Anthology 搜索、Hugging Face 數據集搜索。
• 引用與參考查詢：可通過 Semantic Scholar 獲取論文的引用和參考文獻。
• 網頁處理功能：具備網頁抓取、LaTeX 編譯、PDF 閱讀能力。
• 網絡搜索支持：支持通過 Exa、Brave 或 Tavily 進行網絡搜索。
• 可選的大語言模型工具：提供基於大語言模型的文檔問答和研究提案工作流工具。

📦 安裝指南

普通用戶安裝

使用 pip 進行安裝：

pip3 install academia-mcp

開發者安裝

使用 uv 和 Makefile 進行安裝：

uv venv .venv
make install

💻 使用示例

基礎用法

以下是通過 HTTP 運行的示例：

python -m academia_mcp --transport streamable-http

高級用法

如果你想在 Claude Desktop 中使用，可以按照以下配置：

{
  "mcpServers": {
    "academia": {
      "command": "python3",
      "args": [
        "-m",
        "academia_mcp",
        "--transport",
        "stdio"
      ]
    }
  }
}

📚 詳細文檔

可用工具（單行命令）

• arxiv_search：使用特定領域的查詢和過濾器查詢 ArXiv。
• arxiv_download：通過論文 ID 獲取論文並轉換為結構化文本（支持 HTML/PDF 模式）。
• anthology_search：使用字段查詢和可選的日期過濾搜索 ACL Anthology。
• hf_datasets_search：使用過濾器和排序查找 Hugging Face 數據集。
• s2_get_citations：列出引用給定 ArXiv 論文的論文（基於 Semantic Scholar 圖譜）。
• s2_get_references：列出給定 ArXiv 論文引用的論文。
• visit_webpage：獲取並規範化網頁。
• web_search：統一的搜索包裝器；當設置了 Exa、Brave 或 Tavily 中的至少一個 API 密鑰時可用。
• exa_web_search、brave_web_search、tavily_web_search：特定提供商的搜索。
• get_latex_templates_list、get_latex_template：枚舉和獲取內置的 LaTeX 模板。
• compile_latex：在 WORKSPACE_DIR 中編譯 LaTeX 為 PDF。
• read_pdf：從 PDF 中逐頁提取文本。
• download_pdf_paper、review_pdf_paper：下載並可選地評審 PDF（需要大語言模型和工作區）。
• document_qa：根據提供的文檔塊回答問題（需要大語言模型）。
• extract_bitflip_info、generate_research_proposals、score_research_proposals：研究提案輔助工具（需要大語言模型）。

環境變量

根據你使用的工具，按需設置以下環境變量：

你可以將這些環境變量放在項目根目錄的 .env 文件中。

Docker 部署

構建鏡像

docker build -t academia_mcp .

運行服務器（HTTP）

docker run --rm -p 5056:5056 \
  -e PORT=5056 \
  -e OPENROUTER_API_KEY=your_key_here \
  -e WORKSPACE_DIR=/workspace \
  -v "$PWD/workdir:/workspace" \
  academia_mcp

你也可以使用現有的鏡像：phoenix120/academia_mcp

示例

• 綜合報告演示視頻（YouTube）
• 單篇論文演示視頻（YouTube）

Makefile 目標

• make install：使用 uv 以可編輯模式安裝包。
• make validate：運行 black、flake8 和 mypy（嚴格模式）。
• make test：使用 pytest 運行測試套件。
• make publish：使用 uv 構建併發布。

LaTeX/PDF 依賴

僅 LaTeX/PDF 工具需要這些依賴。確保安裝了 LaTeX 發行版，並且 pdflatex 和 latexmk 在系統路徑中。在 Debian/Ubuntu 上，可使用以下命令安裝：

sudo apt install texlive-latex-base texlive-fonts-recommended texlive-latex-extra texlive-science latexmk

系統要求

• Python 3.12+

許可證

本項目遵循相應的開源許可證，具體請查看 LICENSE 文件。