convez.ai
MCP ServerAutomaçãoIntermediário
weiyvshan

Qinglong MCP Server

weiyvshan/qinglong-mcp-server

Automação completa de painéis Qinglong via MCP com 35 ferramentas

Ver no GitHub
BomPluginScore · de 0 a 100

MCP Server para gerenciar painéis Qinglong com 35 ferramentas de automação. Oferece controle completo sobre tarefas agendadas, variáveis de ambiente, subscrições, dependências e logs. Integra-se nativamente com Claude via stdio.

Instalação

$npx convez-ai weiyvshan/qinglong-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
7
Forks
0
Acompanhando
0
Saúde
85%
Último commit
há 2 dias
Versão
v1.0.14
Issues abertas
0
Contribuidores
2

Casos de uso

  • Gerenciar tarefas agendadas e crons em larga escala
  • Automatizar configuração de variáveis de ambiente
  • Orquestrar subscrições e dependências do painel
  • Integrar gerenciamento Qinglong em fluxos Claude

Veredito

MCP Server robusto e bem-estruturado para gerenciar infraestrutura Qinglong via Claude. Cobertura API completa com tipos TypeScript e suporte a operações em lote, ideal para automação de painéis em produção.

README

A tradução para o português deste README ainda está na fila.

Qinglong MCP Server

CI Version License TypeScript MCP SDK Node.js

基于 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_IDClient ID是-
QL_CLIENT_SECRETClient Secret是-

获取认证信息

  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 上下文文档

相关链接

贡献

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

安全

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

更新日志

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

许可证

MIT License

Ver o original no GitHub

Bom para

Relacionados