青提MCP使用指南
项目简介
青提MCP,旨在通过模型上下文协议(Model Context Protocol,MCP)将青提学术本地数据库与不同 AI 助手衔接,支持自然语言驱动的专业学术查询。
注:如登录过多个账号,会调用当前登录的账户数据或者最后一次登录的数据。
功能特性
- 论文搜索: 支持按标题、作者搜索学术论文,提供分页功能
- PDF文本提取: 从PDF文件中提取文本内容
- 文件夹管理: 支持从特定文件夹检索论文
- 笔记保存: Markdown格式笔记管理系统
系统要求
- 需安装青提学术,推荐 v2.5.0 及以上版本
- 适用于Linux、macOS、Windows系统
快速上手指南
给 CLI 工具自动安装
如果您正在使用 Claude Code、Codex 等支持读取安装说明的 CLI 工具,可以直接复制下面这句话给工具,让它自行读取安装文档并配置 MCP:```text
帮我安装青提 MCP,安装说明地址:
https://raw.githubusercontent.com/aegean-org/qt-mcp/main/INSTALL.md
### 手动安装
如果您不想让 CLI 工具自动读取 `INSTALL.md`,也可以手动配置。手动安装分为两种方式,请先判断您的电脑是否已经安装了 Node.js。
#### 方式 A:电脑已安装 Node.js
先在终端执行以下命令检查:```bash
node -v
npx -v
如果两条命令都能正常输出版本号,说明您的电脑已经安装了 Node.js,可以直接使用 npm 包方式配置 MCP。
Claude Code
已安装 Node.js 时,直接执行:```bash
claude mcp add qt-mcp -- npx -y @aegean-org/qt-mcp stdio
### Codex CLI
已安装 Node.js 时,直接执行:```bash
codex mcp add qt-mcp -- npx -y @aegean-org/qt-mcp stdio
通用 MCP JSON 配置
适用于使用 mcpServers 配置格式的客户端。
已安装 Node.js 时:```json
{
"mcpServers": {
"青提mcp": {
"name": "青提学术",
"type": "stdio",
"description": "学术论文管理和研究辅助工具",
"command": "npx",
"args": ["-y", "@aegean-org/qt-mcp", "stdio"]
}
}
}
#### 方式 B:电脑未安装 Node.js
如果执行 `node -v` 或 `npx -v` 提示命令不存在,说明您的电脑没有安装 Node.js。此时请使用二进制包方式安装。
前往项目的 Releases 页面 下载最新的二进制包:
- **Windows**: 下载 `qt-mcp-windows-amd64.7z`
- **macOS M芯片**: 下载 `qt-mcp-darwin-arm64.7z`
- **macOS Intel芯片**: 下载 `qt-mcp-darwin-amd64.7z`
- **Linux**: 下载 `qt-mcp-linux-amd64.7z`
将下载的压缩包解压到您选择的目录。
### Claude Code
未安装 Node.js 时,将命令改为本地二进制绝对路径:```bash
claude mcp add qt-mcp -- /absolute/path/to/qt-mcp stdio
Codex CLI
未安装 Node.js 时,将命令改为本地二进制绝对路径:```bash
codex mcp add qt-mcp -- /absolute/path/to/qt-mcp stdio
### 通用 MCP JSON 配置
未安装 Node.js 时,将 `command` 改为本地二进制绝对路径,并将 `args` 改为 `["stdio"]`。```json
{
"mcpServers": {
"青提mcp": {
"name": "青提学术",
"type": "stdio",
"description": "学术论文管理和研究辅助工具",
"command": "/absolute/path/to/qt-mcp",
"args": ["stdio"]
}
}
}
使用示例:
"帮我查找一下我的青提学术里所有关于"人工智能"的文献""获取青提学术“计算机”目录里的文献"
| 功能点 | 示意图 |
|---|---|
| 功能说明 | |
| 文献检索 | |
| 元数据查看 | |
| 全文读取 | |
| 基于全文信息进一步提问 | |
| 创建笔记 | |
| 创建文献 |
可用工具
青提MCP提供以下5个核心工具:
1. noteExpressWeb_search_articles
- 功能: 按标题或作者搜索文献
- 参数:
query: 搜索关键词page: 页码(可选)pageSize: 每页数量(可选)
2. noteExpressWeb_get_article_pdf_content
- 功能: 通过文献id/标题获取正文内容
- 参数:
article_id: 文献id
3. noteExpressWeb_search_articles_by_folder
- 功能: 获取指定文件夹中的论文
- 参数:
folder: 文件夹名
4. noteExpressWeb_save_articles
- 功能: 将对应的文献信息保存到青提学术
- 参数:
data: 保存的内容 json格式
5. noteExpressWeb_save_note
- 功能: 保存Markdown格式的研究笔记到对应文献
- 参数:
content: 笔记内容article id: 文献Idnote_id: 笔记id(可选)
支持的 AI 客户端
使用 Stdio 协议,支持与 AI 客户端的实时通信
- Claude Desktop: Stdio MCP 支持
- Cherry Studio: Stdio MCP 支持
- Cursor IDE: Stdio MCP 支持
故障排除
常见问题
- 程序无法启动: 确保下载了正确平台的版本
- 文件下载失败: 检查网络连接和数据目录权限
- 配置文件未找到: 确认数据目录路径设置正确
获取帮助
如有问题或建议,请通过项目的GitHub Issues页面联系我们。
