青提mcp

青提MCP使用指南

项目简介

青提MCP，旨在通过模型上下文协议（Model Context Protocol，MCP）将青提学术本地数据库与不同 AI 助手衔接，支持自然语言驱动的专业学术查询。

注：如登录过多个账号，会调用当前登录的账户数据或者最后一次登录的数据。

功能特性

• 论文搜索: 支持按标题、作者搜索学术论文，提供分页功能
• PDF文本提取: 从PDF文件中提取文本内容
• 文件夹管理: 支持从特定文件夹检索论文
• 笔记保存: Markdown格式笔记管理系统

系统要求

• 需安装青提学术，推荐 v2.5.0 及以上版本
• 适用于Linux、macOS、Windows系统

快速上手指南

给 CLI 工具自动安装

如果您正在使用 Claude Code、Codex 等支持读取安装说明的 CLI 工具，可以直接复制下面这句话给工具，让它自行读取安装文档并配置 MCP：

帮我安装青提 MCP，安装说明地址：
https://raw.githubusercontent.com/aegean-org/qt-mcp/main/INSTALL.md

手动安装

如果您不想让 CLI 工具自动读取 INSTALL.md，也可以手动配置。手动安装分为两种方式，请先判断您的电脑是否已经安装了 Node.js。

方式 A：电脑已安装 Node.js

先在终端执行以下命令检查：

node -v
npx -v

如果两条命令都能正常输出版本号，说明您的电脑已经安装了 Node.js，可以直接使用 npm 包方式配置 MCP。

Claude Code

已安装 Node.js 时，直接执行：

claude mcp add qt-mcp -- npx -y @aegean-org/qt-mcp stdio

Codex CLI

已安装 Node.js 时，直接执行：

codex mcp add qt-mcp -- npx -y @aegean-org/qt-mcp stdio

通用 MCP JSON 配置

适用于使用 mcpServers 配置格式的客户端。

已安装 Node.js 时：

{
  "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 时，将命令改为本地二进制绝对路径：

claude mcp add qt-mcp -- /absolute/path/to/qt-mcp stdio

Codex CLI

未安装 Node.js 时，将命令改为本地二进制绝对路径：

codex mcp add qt-mcp -- /absolute/path/to/qt-mcp stdio

通用 MCP JSON 配置

未安装 Node.js 时，将 command 改为本地二进制绝对路径，并将 args 改为 ["stdio"]。

{
  "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: 文献Id
  • note_id: 笔记id（可选）

支持的 AI 客户端

使用 Stdio 协议，支持与 AI 客户端的实时通信

• Claude Desktop: Stdio MCP 支持
• Cherry Studio: Stdio MCP 支持
• Cursor IDE: Stdio MCP 支持

故障排除

常见问题

1. 程序无法启动: 确保下载了正确平台的版本
2. 文件下载失败: 检查网络连接和数据目录权限
3. 配置文件未找到: 确认数据目录路径设置正确

获取帮助

如有问题或建议，请通过项目的GitHub Issues页面联系我们。