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 个工具)

环境变量管理 (6 个工具)

订阅管理 (7 个工具)

依赖管理 (4 个工具)

脚本管理 (7 个工具)

系统管理 (2 个工具)

配置说明

环境变量

获取认证信息

1. 登录青龙面板
2. 进入 系统设置 -> 开放设置
3. 创建应用并获取 Client ID 和 Client Secret
4. 设置环境变量 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 上下文文档

相关链接

• 使用示例 - 详细的使用场景和示例
• 开发文档 - 架构设计和开发指南
• 青龙面板
• MCP 协议

贡献

欢迎提交 Issue 和 Pull Request！请查看 CONTRIBUTING.md 了解如何参与贡献。

安全

发现安全问题？请查看 SECURITY.md 了解如何报告。

更新日志

查看 CHANGELOG.md 了解版本更新历史。

许可证

MIT License