# 学术论文检索聚合 MCP 服务

基于 Go 语言实现的学术论文检索聚合 MCP (Model Context Protocol) 服务，通过统一接口同时调用多个学术数据库，提供智能去重、合并和排序的搜索结果。

## 功能特性

- 🔍 **多源聚合搜索**: 同时调用6个主要学术数据库
- 🧠 **智能去重合并**: 基于DOI和标题的智能重复检测
- 📊 **统一数据格式**: 标准化的论文元数据结构
- 🚀 **并发高性能**: 异步并行调用所有数据源
- 🎯 **精确结果**: 智能排序和相关性评分
- 🌐 **MCP 协议支持**: 完整的MCP工具接口
- 📝 **详细状态报告**: 实时数据源状态和性能监控

## 支持的数据源

- **arXiv**: 物理学、数学、计算机科学预印本 (免费)
- **Semantic Scholar**: AI驱动的学术搜索引擎 (免费)
- **Crossref**: 全球最大的DOI注册机构 (免费)
- **Scopus**: Elsevier学术数据库 (需要API密钥)
- **ADSABS**: NASA天体物理学数据系统 (需要API密钥)
- **Sci-Hub**: 学术论文PDF获取 (免费，但需注意法律风险)

## 可用工具

### 1. searchScholarPapers - 聚合学术论文搜索

从多个数据源同时搜索学术论文，自动合并去重并排序结果。

**参数:**
- `query` (string): 搜索关键词（必需）
- `author` (string): 作者筛选（可选）
- `title` (string): 标题筛选（可选）
- `journal` (string): 期刊筛选（可选）
- `year` (string): 年份筛选（可选，如"2020-2023"）
- `categories` ([]string): 分类筛选（可选）
- `min_citations` (int): 最小引用数（可选）
- `open_access_only` (bool): 仅开放获取（可选）
- `offset` (int): 偏移量，默认 0
- `limit` (int): 限制数量，默认 10，最大 100
- `sort_by` (string): 排序方式（relevance, citation_count, published_date）
- `sort_order` (string): 排序顺序（asc, desc）
- `enabled_sources` ([]string): 指定数据源（可选）

**基础搜索示例:**
```json
{
  "query": "machine learning"
}
```

**高级搜索示例:**
```json
{
  "query": "deep learning",
  "author": "Hinton",
  "year": "2020-2023",
  "min_citations": 100,
  "open_access_only": true,
  "limit": 20,
  "sort_by": "citation_count",
  "sort_order": "desc"
}
```

**指定数据源示例:**
```json
{
  "query": "quantum computing",
  "enabled_sources": ["arxiv", "semantic_scholar", "crossref"]
}
```

### 2. getScholarPaper - 获取论文详情

根据任意标识符获取特定论文的完整信息，自动选择最佳数据源。

**参数:**
- `identifier` (string): 论文标识符（必需）

**DOI查询示例:**
```json
{
  "identifier": "10.1038/nature12373"
}
```

**arXiv ID查询示例:**
```json
{
  "identifier": "2301.07041"
}
```

## 安装和运行

### 环境要求
- Go 1.24+
- 网络连接（访问各学术数据库API）
- 可选：Scopus API密钥
- 可选：ADSABS API密钥

### 快速启动

1. **克隆项目**
```bash
git clone https://github.com/Seelly/scholar_mcp_server.git
cd scholar_mcp_server
```

2. **安装依赖**
```bash
go mod tidy
```

3. **基础运行（使用免费数据源）**
```bash
go run main.go logging.go
```

### 完整功能运行

配置API密钥以启用全部功能：

```bash
# 设置API密钥
export SCOPUS_API_KEY="your_scopus_api_key"
export ADSABS_API_KEY="your_adsabs_api_key"

# 运行服务器
go run main.go logging.go
```

### 生产部署

```bash
# 编译二进制文件
go build -o scholar-server main.go logging.go

# 后台运行
nohup ./scholar-server > server.log 2>&1 &
```

服务器将在 `http://127.0.0.1:8080/` 启动。

## MCP 客户端配置

### Claude Desktop 配置

在 `~/.cursor/mcp.json` 或 Claude Desktop 配置文件中添加:

```json
{
  "mcpServers": {
    "arXiv论文检索服务": {
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}
```

## 使用示例

### 搜索论文
```bash
# 使用 curl 测试搜索功能
curl -X POST http://127.0.0.1:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "searchArxivPapers",
      "arguments": {
        "query": "deep learning",
        "max_results": 5
      }
    }
  }'
```

### 获取论文详情
```bash
curl -X POST http://127.0.0.1:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "getArxivPaper",
      "arguments": {
        "id": "2301.07041"
      }
    }
  }'
```