Skip to main content
Glama
Qinglong MCP Server

Qinglong MCP Server

by pholex

青龙面板 MCP Server

PyPI version

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

说明:本仓库包含源代码,供开发者参考。普通用户请直接通过 pip 或 uvx 安装使用。

功能

  • list_qinglong_tasks: 查询青龙面板中的所有定时任务列表

  • run_task: 执行任务并等待完成,自动返回执行日志(最多等待30秒)

  • run_task_async: 异步启动任务,不等待执行完成

  • get_task_logs: 获取青龙面板中指定任务的执行日志

  • get_task_status: 获取青龙面板中指定任务的执行状态

  • list_subscriptions: 查询青龙面板中的所有订阅列表

  • run_subscription: 运行指定的订阅

Related MCP server: TickTick MCP Server

安装

使用 pip 安装:

pip install qinglong-mcp-server

或使用 uvx(推荐,无需安装):

uvx qinglong-mcp-server

配置

首次运行时会自动创建配置文件模板。

编辑配置文件:

macOS/Linux:

nano ~/.qinglong-mcp/.env

Windows:

notepad %USERPROFILE%\.qinglong-mcp\.env

填入你的青龙面板信息:

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

使用

在 MCP 客户端中使用

编辑 MCP 配置文件,添加以下内容:

{
  "mcpServers": {
    "qinglong": {
      "command": "uvx",
      "args": ["qinglong-mcp-server"]
    }
  }
}

配置文件位置(以 Kiro CLI 为例):

  • ~/.kiro/settings/mcp.json

开发测试

运行测试脚本:

./test_query_tasks.py

升级

pip install -U qinglong-mcp-server

项目地址

联系方式

Email: pholex@gmail.com

Available Tools

7 tools
get_task_logsC

获取青龙面板中指定任务的执行日志

Inputs: task_id (required).

get_task_statusC

获取青龙面板中指定任务的执行状态

Inputs: task_id (required).

list_qinglong_tasksB

查询青龙面板中的所有定时任务列表

Inputs: no named parameters.

list_subscriptionsB

查询青龙面板中的所有订阅列表

Inputs: no named parameters.

run_subscriptionC

运行指定的订阅

Inputs: subscription_id (required).

run_taskB

执行任务并等待完成,返回执行日志(最多等待30秒)

Inputs: task_id (required).

run_task_asyncC

异步启动任务,不等待执行完成

Inputs: task_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no ambiguity. Tools target specific resources (tasks, subscriptions) and actions (get logs, get status, list, run), ensuring agents can easily differentiate between them.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (e.g., get_task_logs, list_qinglong_tasks, run_subscription). The naming is uniform and predictable, making the set easy to navigate.

    Tool Count5/5

    With 7 tools, the server is well-scoped for managing Qinglong tasks and subscriptions. Each tool serves a clear function, covering core operations without being overly sparse or bloated.

    Completeness4/5

    The tool set provides strong coverage for task and subscription management, including listing, running, and monitoring. A minor gap exists in update or delete operations for tasks and subscriptions, but agents can still handle most workflows effectively.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers