Qinglong MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Qinglong MCP Server list all my scheduled tasks"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
青龙面板 MCP Server
这是一个 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/.envWindows:
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 toolsget_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
Scored across 7 tools
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.
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.
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.
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
Related MCP Connectors
Schedule and manage recurring or one-shot tasks
Manage CronPulser from an AI agent: HTTP, Runner and TLS jobs, alerts, Runners and run history.
Manage scheduled requests, uptime monitors and heartbeats from your AI assistant.
Manage cron jobs, machines and run history in your norc account from any AI chat.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to interact with ZenTao project management system, supporting project and task management operations including creating, querying, and updating projects and tasks through natural language.5ISC
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage TickTick tasks including listing, creating, updating, completing, and deleting tasks, as well as searching and filtering.-
- FlicenseNot gradedqualityDmaintenanceEnables natural language management of ZenTao tasks in Claude, including listing executions/tasks, batch creating/updating/closing tasks, and uploading image/video attachments.1-
- FlicenseNot gradedqualityCmaintenanceEnables task management in TickTick with full CRUD operations, advanced filtering, GTD workflows, reminders, subtasks, and optional V2 API features for tags, completed tasks, and search.1-