README.md•4.52 kB
# 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" />
