青提学术 MCP 支持自适应环境配置与自动化部署

aegeansupport

针对此前 “青提学术 MCP 发布：快捷链接AI与青提学术” MCP 配置过程中存在的“环境依赖”和“路径配置繁琐”问题，青提学术 MCP 服务现已完成核心升级。


本次更新引入了“自适应运行时”机制。无论您的终端是否安装 Node.js 环境，系统均可自动适配；同时，我们支持通过标准指令触发自动化部署流程。


一、自动化部署（推荐）

如果您使用的是支持读取上下文文档的 AI 终端（如 Claude Code），现在无需手动修改配置文件。您只需输入以下指令，AI 将自动读取安装文档并完成环境检测与配置：

1. 帮我安装青提 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 时，直接执行：

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

复制代码

Codex CLI

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

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

复制代码

通用 MCP JSON 配置

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

已安装 Node.js 时：

1. {
   
2.   "mcpServers": {
   
3.     "青提mcp": {
   
4.       "name": "青提学术",
   
5.       "type": "stdio",
   
6.       "description": "学术论文管理和研究辅助工具",
   
7.       "command": "npx",
   
8.       "args": ["-y", "@aegean-org/qt-mcp", "stdio"]
   
9.     }
   
10.   }
    
11. }

复制代码

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

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

复制代码

Codex CLI

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

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

复制代码

通用 MCP JSON 配置

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

1. {
   
2.   "mcpServers": {
   
3.     "青提mcp": {
   
4.       "name": "青提学术",
   
5.       "type": "stdio",
   
6.       "description": "学术论文管理和研究辅助工具",
   
7.       "command": "/absolute/path/to/qt-mcp",
   
8.       "args": ["stdio"]
   
9.     }
   
10.   }
    
11. }

复制代码