qinglong-mcp-server 0.1.0

MCP server for Qinglong Panel task management

青龙面板 MCP Server

这是一个 Model Context Protocol (MCP) server，用于查询和执行青龙面板中的定时任务。

功能

• list_qinglong_tasks: 查询青龙面板中的所有定时任务列表
• run_task: 执行任务并等待完成，自动返回执行日志（最多等待30秒）
• run_task_async: 异步启动任务，不等待执行完成
• get_task_logs: 获取青龙面板中指定任务的执行日志
• get_task_status: 获取青龙面板中指定任务的执行状态

安装

pip install -r requirements.txt

配置

复制 .env.example 为 .env 并配置青龙面板信息：

cp .env.example .env

编辑 .env 文件：

QINGLONG_URL=https://your-qinglong-url.com
CLIENT_ID=your_client_id
CLIENT_SECRET=your_client_secret

使用

在 Kiro CLI 中使用

编辑 Kiro CLI 的 MCP 配置文件（~/.kiro/settings/mcp.json）：

{
  "mcpServers": {
    "qinglong": {
      "command": "python3",
      "args": ["/path/to/qinglong-mcp-server/server.py"],
      "autoApprove": ["list_qinglong_tasks", "run_task"]
    }
  }
}

测试工具

运行 query_tasks.py 测试 API 连接并查看任务列表：

./query_tasks.py

工具说明

list_qinglong_tasks

查询所有任务，无需参数。

run_task

执行任务并等待完成，自动返回执行日志（最多等待30秒），需要提供：

• task_id: 任务 ID（整数）

run_task_async

异步启动任务，不等待执行完成，需要提供：

• task_id: 任务 ID（整数）

get_task_logs

获取任务执行日志，需要提供：

• task_id: 任务 ID（整数）

get_task_status

获取任务执行状态，需要提供：

• task_id: 任务 ID（整数）