# Aminer Mcp Server

> A Model Context Protocol (MCP) server providing powerful academic paper search and analysis functionality through the AMiner API.

- **Type:** MCP server
- **Install:** `agentstack add mcp-scipenai-aminer-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [scipenai](https://agentstack.voostack.com/s/scipenai)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [scipenai](https://github.com/scipenai)
- **Source:** https://github.com/scipenai/aminer-mcp-server

## Install

```sh
agentstack add mcp-scipenai-aminer-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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！

## 📞 支持

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

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [scipenai](https://github.com/scipenai)
- **Source:** [scipenai/aminer-mcp-server](https://github.com/scipenai/aminer-mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-scipenai-aminer-mcp-server
- Seller: https://agentstack.voostack.com/s/scipenai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.