v3.2.1 版本更新后，青提 MCP 随软件一起安装，无需额外下载工具，即可让你的 AI 客户端直接读写本机文献库：浏览与检索题录、读取笔记与附件、管理题录、导入导出等。接口随青提启动自动提供，无需额外安装命令行工具。

另有 neweb-harness Skill 包，可免去手动配置，自动连接 MCP 、让助手解答青提用法、生成 CSL 文件，详见青提学术 Harness。

1. 接入方式

前提：青提学术已启动并登录。

在 AI 客户端中配置

打开客户端的 MCP 设置，新建一个 MCP Server。
类型选 HTTP / Streamable HTTP，URL 填入：
```
http://127.0.0.1:49528/mcp
```
保存后确认已连接；在对话中应能看到青提提供的工具。

若客户端使用配置文件（常见为 mcp.json），可加入：
```
{
"mcpServers": {
  "qt-mcp": {
    "url": "http://127.0.0.1:49528/mcp"
  }
}
}
```

若客户端要求显式 transport，按其文档选用 streamableHttp 或等价 HTTP 选项，URL 不变。

连接检查

配置保存后，除观察工具显示外，还可通过发送如下指令验证是否连接成功，

「看一下青提当前的连接与登录状态」

AI 能返回连接与登录状态，说明已连接成功。

若没有回应或报错：确认青提正在运行并已登录，然后重新保存一次 MCP 配置。

指令示例

直接在对话框里用自然语言下指令，AI 会自动调用青提相关工具：

「帮我在文献库里搜一下 transformer 综述」
「把这篇 PDF 第 3 页的要点记到文献 N」
「新建『待精读』文件夹，把最近 10 篇加进去」
「把我刚下载的 xxx.pdf 加进我的文献库」

2. 与旧版外部桥的区别

	内嵌 MCP（本页）	旧版外部桥（过渡）
地址	`127.0.0.1:49528/mcp`	常见为独立 exe / 其他端口
工具前缀	`qt_*`	`noteExpressWeb_` / `noteexpress_`
启动条件	青提登录后主窗口起来	依赖外部进程 / 命令行

Agent 侧请只配置并调用 qt_*。

3. 工具清单（共 25 个）

状态与浏览 / UI

工具名	作用
`qt_get_status`	登录状态、库信息、写锁队列
`qt_get_ui_focus`	读取当前主窗口焦点（所在文件夹 / 标题等）
`qt_list_folders`	分页列文件夹（默认 limit 50；可选 `parent_id`）
`qt_list_articles`	分页浏览题录（可选 `folder_id`）
`qt_search_articles`	按标题/作者/DOI/年份/夹搜索（需登录）
`qt_search_articles_by_folder`	按文件夹名称（含子夹）列题录

题录 / 笔记 / 附件 / PDF

工具名	作用
`qt_get_article`	取单篇；`mode=summary`（默认）或 `full`
`qt_get_note`	读笔记（`note_id` 或按 `article_id` 分页）
`qt_list_attachments`	列附件及本地是否存在
`qt_get_article_pdf_content`	抽取本地 PDF 全文（需归属当前账号）

类型 Schema

工具名	作用
`qt_list_article_types`	列题录类型
`qt_get_article_type_fields`	取某类型可写/可读字段 schema

写入与整理

工具名	作用
`qt_save_note`	新建/更新 Markdown 笔记
`qt_save_articles`	批量新建题录（JSON；可选类型 schema）
`qt_update_article`	更新已有题录字段
`qt_create_folder`	新建文件夹
`qt_delete_folders`	软删文件夹到回收站（并解除关联）
`qt_link_articles`	链接到文件夹（保留原关联）
`qt_move_articles`	移动到文件夹
`qt_delete_articles`	软删到回收站
`qt_import_formatted`	导入 RIS/BibTeX 等
`qt_import_pdf`	从本地 PDF 创建题录（保存 + 附件）
`qt_export_articles`	导出为 RIS/BibTeX 等文本
`qt_attach_file`	挂本地文件为附件（不上云）
`qt_dedupe_articles`	查重预览 / 软删重复项

历史版本存档

项目地址

https://github.com/aegean-org/qt-mcp

项目简介

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

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

功能特性

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

系统要求

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

快速上手指南

下载程序

前往项目的 Releases 页面下载最新的二进制包：

Windows: 下载 qt-mcp-windows.zip
macOS: 下载 qt-mcp-darwin.zip
Linux: 下载 qt-mcp-linux.zip

解压安装

将下载的压缩包解压到您选择的目录，例如：

Windows: C:\Program Files\
macOS: ~/Downloads/
Linux: /usr/local/bin/ 或 ~/bin/

MCP客户端配置

在支持的AI客户端MCP中添加以下配置：

{
  "mcpServers": {
    "青提mcp": {
      "name": "青提学术",
      "type": "stdio",
      "description": "学术论文管理和研究辅助工具",
      "command": "/你的电脑目录/qt-mcp.exe", // 替换为实际路径
      "args": []
    }
  }
}