内容
# 📚 3合1学术MCP服务器
本仓库包含一个统一的模型上下文协议（MCP）配置，该配置将三个强大的学术研究服务器无缝集成到一个工作空间中。这使得AI助手（例如Claude、Roo或Cursor）能够搜索、获取并分析来自网络各处的学术文献。
## 🚀 包含的3个服务器
1. **`paper-search-mcp`**: 终极搜索引擎。它从数十个平台搜索和下载论文，包括Semantic Scholar、arXiv、CORE、IEEE、PubMed、Crossref、Zenodo和Unpaywall。
2. **`papermaster`**: 一个快速、本地的基于Python的MCP服务器，专门用于获取和下载特定的文献，并管理本地学术数据。
3. **`scopus-mcp`**: 一个用于查询爱思唯尔Scopus数据库的专用服务器。它获取高度准确的摘要、引用论文和作者简介。这三个服务器都包含在此仓库中！
---
## 🛠️ 设置与安装
按照以下步骤，立即在您的AI助手上运行这三个服务器。
### 1. 先决条件
- **Python 3.10+** 已安装在您的系统上。
- **`uv` 包管理器**（通过 `curl -LsSf https://astral.sh/uv/install.sh | sh` 安装）。
### 2. 配置您的API密钥
为了保护您的API密钥，我们使用一个 `.env` 文件，该文件被git故意忽略。
1. 复制示例环境文件：
```bash
cp .env.example .env
```
2. 打开 `.env` 并填写您的密钥：
- `SCOPUS_API_KEY` （Scopus必填）
- `PAPER_SEARCH_MCP_CORE_API_KEY` （可选但推荐）
- `PAPER_SEARCH_MCP_SEMANTIC_SCHOLAR_API_KEY` （可选但推荐）
- `PAPER_SEARCH_MCP_IEEE_API_KEY` （IEEE下载可选）
### 3. 生成工作空间配置
运行设置脚本，将您的秘密API密钥注入本地MCP配置：
```bash
python3 build_config.py
```
*这将创建一个包含您的密钥的 `.roo/mcp.json` 文件。*
### 4. 开始使用！
只需在VSCode中 **打开此文件夹** （`mcp-literature-server` / `mcp_config_project`）。
如果您正在使用Roo/Cline扩展，它将自动检测 `.roo/mcp.json` 文件，并在后台启动所有三个服务器。您可以立即询问您的AI：
> *"为我找到5篇关于PDDL和LLMs的近期论文，来自IEEE和Scopus，并下载最相关的论文。"*
---
## 🔒 安全注意事项
- 永远不要将您的 `.env` 或 `.roo/mcp.json` 文件提交到Git。 `.gitignore` 已经配置好以防止这种情况发生。
- 如果您想修改服务器参数（例如超时或路径），请编辑 `mcp_settings.example.json`，然后重新运行 `build_config.py`。
