# AMiner MCP 服务器

> **语言 / Language:** [🇨🇳 中文](README.md) | [🇺🇸 English](README.en.md)

基于模型上下文协议（MCP）的服务器，通过 AMiner API 提供强大的学术论文搜索和分析功能。

## 🌟 功能特性

### 🔍 搜索工具
- **关键词搜索** (`search_papers_by_keyword`) - 通过关键词搜索论文
- **期刊搜索** (`search_papers_by_venue`) - 搜索特定期刊/会议的论文
- **作者搜索** (`search_papers_by_author`) - 搜索特定作者的论文
- **高级搜索** (`search_papers_advanced`) - 多条件组合搜索

### 🤖 AI 助手
- **论文搜索助手** (`paper_search_assistant`) - 学术研究辅助的 AI 提示模板

### ⚙️ 搜索选项
- 分页支持（页码、每页数量）
- 排序选项（按年份或引用数）
- 详细论文信息展示
- 专业学术格式的英文界面


## 🔧 MCP 客户端配置

添加到您的 MCP 客户端配置文件：

```json
{
  "mcpServers": {
    "aminer": {
      "command": "npx",
      "args": ["-y", "@scipen/aminer-mcp-server"],
      "env": {
        "AMINER_API_KEY": "YOUR_AMINER_API_KEY"
      }
    }
  }
}
```

## 🚀 手动运行

```bash
# 设置您的 AMiner API 密钥：
export AMINER_API_KEY="your_aminer_api_key_here"
# 使用 npx 启动
npx -y @scipen/aminer-mcp-server
```


## 📚 工具列表

### search_papers_by_keyword

通过关键词搜索学术论文。

**参数：**
- `keyword` (字符串，必需): 搜索关键词
- `page` (数字，可选): 页码，默认 0
- `size` (数字，可选): 每页论文数，默认 10，最大 10
- `order` (字符串，可选): 排序方式：'year' 或 'n_citation'

**示例：**
```json
{
  "keyword": "深度学习",
  "page": 0,
  "size": 5,
  "order": "n_citation"
}
```

### search_papers_by_venue

搜索特定期刊/会议发表的论文。

**参数：**
- `venue` (字符串，必需): 期刊/会议名称
- `page` (数字，可选): 页码，默认 0
- `size` (数字，可选): 每页论文数，默认 10，最大 10
- `order` (字符串，可选): 排序方式：'year' 或 'n_citation'

**示例：**
```json
{
  "venue": "Nature",
  "page": 0,
  "size": 10,
  "order": "year"
}
```

### search_papers_by_author

搜索特定作者发表的论文。

**参数：**
- `author` (字符串，必需): 作者姓名
- `page` (数字，可选): 页码，默认 0
- `size` (数字，可选): 每页论文数，默认 10，最大 10
- `order` (字符串，可选): 排序方式：'year' 或 'n_citation'

**示例：**
```json
{
  "author": "Geoffrey Hinton",
  "page": 0,
  "size": 10
}
```

### search_papers_advanced

支持多条件的高级搜索。

**参数：**
- `keyword` (字符串，可选): 搜索关键词
- `venue` (字符串，可选): 期刊/会议名称
- `author` (字符串，可选): 作者姓名
- `page` (数字，可选): 页码，默认 0
- `size` (数字，可选): 每页论文数，默认 10，最大 10
- `order` (字符串，可选): 排序方式：'year' 或 'n_citation'

**注意：** 必须提供 keyword、venue 或 author 中的至少一个。

**示例：**
```json
{
  "keyword": "自然语言处理",
  "author": "Yann LeCun",
  "page": 0,
  "size": 5,
  "order": "n_citation"
}
```

## 🎯 提示模板

### paper_search_assistant

学术研究的 AI 助手提示模板。

**参数：**
- `research_topic` (字符串，必需): 研究主题或领域
- `search_focus` (字符串，可选): 搜索重点
  - `recent`: 关注最新论文
  - `highly_cited`: 关注高引用论文
  - `comprehensive`: 平衡搜索（默认）

**示例：**
```json
{
  "research_topic": "计算机视觉中的注意力机制",
  "search_focus": "highly_cited"
}
```

## 🛠️ 开发

### 项目结构

```
src/
├── index.ts          # 主服务器文件
├── aminer-client.ts  # AMiner API 客户端
└── types.ts          # 类型定义
```

### 可用脚本

- `pnpm run build` - 构建项目
- `pnpm run start` - 启动服务
- `pnpm run dev` - 开发模式
- `pnpm run lint` - 代码检查
- `pnpm test` - 运行测试

### 技术栈

- **运行时**: Node.js 18+
- **语言**: TypeScript
- **框架**: Model Context Protocol SDK
- **包管理器**: pnpm
- **API**: AMiner 开放平台 API
- **协议**: JSON-RPC 2.0 (MCP)

## 📄 许可证

MIT 许可证

## 🤝 贡献

欢迎提交 Issues 和 Pull Requests！

## 📞 支持

如有问题和支持需求, 请添加小助手的企业微信：

<img src="qrcode.jpg" alt="企业微信二维码" width="200" />