学术MCP
   ](https://smithery.ai/server/@IlyaGusev/academia_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编译为PDFWORKSPACE_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：启用Tavilyweb_search.EXA_API_KEY：启用Exaweb_search和visit_webpage.BRAVE_API_KEY：启用Braveweb_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
例子
生成文件目标
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