Academia MCP

用于搜索、获取、分析和报告科学论文和数据集的MCP服务器。

特性

• ArXiv搜索与下载
• ACL文集搜索
• Hugging Face数据集搜索
• Semantic Scholar引用与参考文献
• 通过Exa、Brave或Tavily进行网络搜索
• 网页爬虫、LaTeX编译、PDF阅读
• 可选的LLM驱动工具，用于文档QA和研究提案工作流程

要求

• Python 3.12+

安装

• 使用pip（最终用户）：

pip3 install academia-mcp

• 开发环境（uv + Makefile）：

uv venv .venv
make install

快速开始

• 通过HTTP运行（默认传输方式）：

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

• 通过标准输入输出运行（适用于本地MCP客户端如Claude Desktop）：

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_search：使用特定领域的查询和过滤器查询arXiv。
• arxiv_download：通过ID获取论文并转换为结构化文本（HTML/PDF模式）。
• anthology_search：使用字段查询搜索ACL文集，并可选日期过滤。
• hf_datasets_search：使用过滤器和排序查找Hugging Face数据集。
• s2_get_citations：列出引用给定arXiv论文的论文（Semantic Scholar图谱）。
• s2_get_references：列出被给定arXiv论文引用的论文。
• visit_webpage：获取并规范化网页。
• web_search：统一搜索包装器；当至少有一个Exa/Brave/Tavily密钥设置时可用。
• 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（需要LLM + 工作区）。
• document_qa：回答提供的文档片段的问题（需要LLM）。
• extract_bitflip_info，generate_research_proposals，score_research_proposals：研究提案助手（需要LLM）。

可用性说明：

• 设置WORKSPACE_DIR以启用compile_latex，read_pdf，download_pdf_paper和review_pdf_paper。
• 设置OPENROUTER_API_KEY以启用LLM工具（document_qa，review_pdf_paper和bitflip工具）。
• 设置一个或多个EXA_API_KEY，BRAVE_API_KEY，TAVILY_API_KEY以启用web_search和提供商工具。

环境变量

根据使用的工具设置：

• OPENROUTER_API_KEY：LLM相关工具所需。
• BASE_URL：覆盖OpenRouter基础URL。
• DOCUMENT_QA_MODEL_NAME：覆盖document_qa的默认模型。
• BITFLIP_MODEL_NAME：覆盖bitflip工具的默认模型。
• TAVILY_API_KEY：启用Tavily的web_search。
• EXA_API_KEY：启用Exa的web_search和visit_webpage。
• BRAVE_API_KEY：启用Brave的web_search。
• WORKSPACE_DIR：生成文件的目录（PDFs，临时工件）。
• PORT：HTTP端口（默认5056）。

您可以将这些放在项目根目录下的.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在PATH上，以及latexmk。在Debian/Ubuntu上：

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