⚡
qinglong-server
青龙面板 MCP 服务器 - 基于 Model Context Protocol 的青龙面板管理工具
0 installs
Trust: 39 — Low
Automation
Installation
npx qinglong-mcp-serverAsk AI about qinglong-server
Powered by Claude · Grounded in docs
I know everything about qinglong-server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
Qinglong MCP Server
基于 MCP (Model Context Protocol) 的青龙面板管理服务器,提供 35 个工具用于管理定时任务、环境变量、订阅、依赖、脚本和系统配置。
特性
- 完整 API 覆盖 - 35 个工具覆盖青龙面板核心功能
- 类型安全 - TypeScript + Zod 双重类型保障
- 本地运行 - 基于 stdio 标准输入输出,与 Claude Code 无缝集成
- 双格式输出 - Markdown (人类可读) 和 JSON (机器可读)
- 自动认证 - 使用 Client Credentials 自动获取 Token
- 批量操作 - 支持批量管理任务和环境变量
快速开始
方式 A:直接使用 npm(推荐)
npm install -g qinglong-mcp-server
方式 B:使用 npx(无需全局安装)
npx qinglong-mcp-server
配置环境变量(两种方式都需要)
在青龙面板中创建 Client Credentials,得到 client_id 和 client_secret,并配置以下环境变量:
export QL_URL="http://localhost:5700"
export QL_CLIENT_ID="your_client_id"
export QL_CLIENT_SECRET="your_client_secret"
与 Claude Code 集成
编辑 ~/.claude/mcp.json(全局安装时):
{
"mcpServers": {
"qinglong": {
"command": "qinglong-mcp",
"env": {
"QL_URL": "http://your-qinglong:5700",
"QL_CLIENT_ID": "your_client_id",
"QL_CLIENT_SECRET": "your_client_secret"
}
}
}
}
如果你用的是源码方式(开发者/贡献者),请改用:
{
"mcpServers": {
"qinglong": {
"command": "node",
"args": ["/absolute/path/to/qinglong-mcp-server/dist/index.js"],
"env": {
"QL_URL": "http://your-qinglong:5700",
"QL_CLIENT_ID": "your_client_id",
"QL_CLIENT_SECRET": "your_client_secret"
}
}
}
}
源码运行(开发者)
git clone https://github.com/weiyvshan/qinglong-mcp-server.git
cd qinglong-mcp-server
npm install
npm run build
npm start
功能模块
定时任务管理 (9 个工具)
| 工具 | 功能 | 类型 |
|---|---|---|
qinglong_list_crons | 列出定时任务 | 只读 |
qinglong_create_cron | 创建定时任务 | 写入 |
qinglong_update_cron | 更新定时任务 | 写入 |
qinglong_delete_crons | 删除定时任务 | 破坏性 |
qinglong_run_crons | 运行定时任务 | 写入 |
qinglong_stop_crons | 停止定时任务 | 写入 |
qinglong_enable_crons | 启用定时任务 | 写入 |
qinglong_disable_crons | 禁用定时任务 | 写入 |
qinglong_get_cron_log | 查看任务日志 | 只读 |
环境变量管理 (6 个工具)
| 工具 | 功能 | 类型 |
|---|---|---|
qinglong_list_envs | 列出环境变量 | 只读 |
qinglong_create_envs | 创建环境变量(支持批量) | 写入 |
qinglong_update_env | 更新环境变量 | 写入 |
qinglong_delete_envs | 删除环境变量 | 破坏性 |
qinglong_enable_envs | 启用环境变量 | 写入 |
qinglong_disable_envs | 禁用环境变量 | 写入 |
订阅管理 (7 个工具)
| 工具 | 功能 | 类型 |
|---|---|---|
qinglong_list_subscriptions | 列出订阅 | 只读 |
qinglong_create_subscription | 创建订阅 | 写入 |
qinglong_update_subscription | 更新订阅 | 写入 |
qinglong_delete_subscriptions | 删除订阅 | 破坏性 |
qinglong_run_subscriptions | 运行订阅 | 写入 |
qinglong_enable_subscriptions | 启用订阅 | 写入 |
qinglong_disable_subscriptions | 禁用订阅 | 写入 |
依赖管理 (4 个工具)
| 工具 | 功能 | 类型 |
|---|---|---|
qinglong_list_dependencies | 列出依赖 | 只读 |
qinglong_create_dependencies | 创建依赖 | 写入 |
qinglong_delete_dependencies | 删除依赖 | 破坏性 |
qinglong_reinstall_dependencies | 重装依赖 | 写入 |
脚本管理 (7 个工具)
| 工具 | 功能 | 类型 |
|---|---|---|
qinglong_list_scripts | 列出脚本文件 | 只读 |
qinglong_get_script | 获取脚本内容 | 只读 |
qinglong_create_script | 创建脚本 | 写入 |
qinglong_update_script | 更新脚本 | 写入 |
qinglong_delete_script | 删除脚本 | 破坏性 |
qinglong_run_script | 运行脚本 | 写入 |
qinglong_stop_script | 停止脚本 | 写入 |
系统管理 (2 个工具)
| 工具 | 功能 | 类型 |
|---|---|---|
qinglong_get_system_info | 获取系统信息 | 只读 |
qinglong_send_notification | 发送系统通知 | 写入 |
配置说明
环境变量
| 变量 | 描述 | 必需 | 默认值 |
|---|---|---|---|
QL_URL | 青龙面板地址 | 否 | http://localhost:5700 |
QL_CLIENT_ID | Client ID | 是 | - |
QL_CLIENT_SECRET | Client Secret | 是 | - |
获取认证信息
- 登录青龙面板
- 进入
系统设置->开放设置 - 创建应用并获取
Client ID和Client Secret - 设置环境变量
QL_CLIENT_ID和QL_CLIENT_SECRET
项目结构
qinglong-mcp-server/
├── src/
│ ├── index.ts # 主入口文件
│ ├── constants.ts # 常量定义
│ ├── types.ts # 类型定义
│ ├── schemas/ # Zod 验证模式
│ ├── services/ # 服务层
│ └── tools/ # 工具实现
├── dist/ # 编译输出
├── package.json
├── tsconfig.json
├── README.md
├── EXAMPLES.md # 使用示例
├── DEVELOPMENT.md # 开发文档
└── CLAUDE.md # AI 上下文文档
相关链接
贡献
欢迎提交 Issue 和 Pull Request!请查看 CONTRIBUTING.md 了解如何参与贡献。
安全
发现安全问题?请查看 SECURITY.md 了解如何报告。
更新日志
查看 CHANGELOG.md 了解版本更新历史。
