yarxiv MCP

学术MCP

MCP服务器，具有搜索、获取、分析和报告科学论文和数据集的工具。

特性

• ArXiv搜索与下载
• ACL选集搜索
• 拥抱脸数据集搜索
• 语义学者引用和参考文献
• 通过Exa、Brave或Tavily进行网络搜索
• 网页爬虫，LaTeX编译，PDF阅读
• 用于文档质量保证和研究提案工作流程的可选LLM驱动工具

需求

• Python 3.12+

安装

• 使用pip（最终用户）：

pip3 install academia-mcp

• 对于开发（uv+Makefile）：

uv venv .venv
make install

快速入门

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

python -m academia_mcp --transport streamable-http
# OR
uv run -m academia_mcp --transport streamable-http

• 在stdio上运行（适用于本地MCP客户端，如Claude Desktop）：

python -m academia_mcp --transport stdio
# OR
uv run -m academia_mcp --transport stdio

笔记：

• 运输： stdio, sse, streamable-http.
• host/port 用于HTTP传输；忽略为 stdio默认端口为 5056 （或 PORT).

认证

Academia MCP支持HTTP传输的可选基于令牌的身份验证(streamable-http 和 sse).默认情况下禁用身份验证以保持向后兼容性。

启用身份验证

设置 ENABLE_AUTH 环境变量 true:

export ENABLE_AUTH=true
export TOKENS_FILE=/path/to/tokens.json  # Optional, defaults to ./tokens.json

管理代币

发布新令牌：

academia_mcp auth issue-token --client-id=my-client --description="Production API client"

# Issue token with 30-day expiration
academia_mcp auth issue-token --client-id=test-client --expires-days=30

# Issue token with custom scopes
academia_mcp auth issue-token --client-id=admin --scopes="read,write,admin"

列出活动令牌：

academia_mcp auth list-tokens

撤销令牌：

academia_mcp auth revoke-token mcp_a1b2c3d4e5f6...

使用代币

将令牌包含在 Authorization 标题与 Bearer scheme或作为查询参数apiKey。

安全说明：

• 代币在发行过程中只显示一次。安全地存放它们。
• 在生产环境中使用HTTPS来保护传输中的令牌。
• 这 tokens.json 自动创建具有限制权限的文件（模式600）。
• 令牌以明文存储（承载令牌的标准做法）-保护令牌文件。

Claude桌面配置

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

可用工具（一个衬垫）

• arxiv_search：使用特定于字段的查询和过滤器查询arXiv。
• arxiv_download：按ID提取论文并转换为结构化文本（HTML/PDF模式）。
• anthology_search：使用已处理的查询和可选的日期过滤搜索ACL选集。
• hf_datasets_search：使用过滤器和排序查找拥抱脸数据集。
• s2_get_citations：列出引用给定arXiv论文（语义学者图）的论文。
• s2_get_references：列出给定arXiv论文引用的论文。
• visit_webpage：获取并规范化网页。
• web_search：统一搜索包装器；当设置了Exa/BBrave/Tavily键中的至少一个时可用。
• exa_web_search, brave_web_search, tavily_web_search：特定于提供商的搜索。
• get_latex_templates_list, get_latex_template：枚举并获取内置的LaTeX模板。
• compile_latex：将LaTeX编译为PDF WORKSPACE_DIR.
• read_pdf：从PDF中提取每页文本。
• download_pdf_paper, review_pdf_paper：下载并可选择查看PDF（需要LLM+工作区）。
• document_qa：在提供的文档块上回答问题（需要法学硕士）。
• extract_bitflip_info, generate_research_proposals, score_research_proposals：研究提案助手（需要法学硕士）。

可用性说明：

• 集 WORKSPACE_DIR 启用 compile_latex, read_pdf, download_pdf_paper，以及 review_pdf_paper.
• 集 OPENROUTER_API_KEY 启用LLM工具(document_qa, review_pdf_paper和位翻转工具）。
• 设置以下一项或多项 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：覆盖位翻转工具的默认模型。
• TAVILY_API_KEY：启用Tavily web_search.
• EXA_API_KEY：启用Exa web_search 和 visit_webpage.
• BRAVE_API_KEY：启用Brave web_search.
• WORKSPACE_DIR：生成文件（PDF、临时工件）的目录。
• PORT：HTTP端口（默认 5056).

你可以把这些放在 .env 项目根目录中的文件。

码头工人

塑造形象：

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）

生成文件目标

• make install：使用uv以可编辑模式安装软件包
• make validate：运行黑色、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