Qinglong

This MCP Server provides a way to query QingLong panel timed tasks, execute them, monitor their status and logs, and manage subscriptions through a consistent MCP interface. It’s useful for automating task orchestration across your QingLong instances from any MCP client.

How to use

You connect to the QingLong MCP Server from your MCP client and perform actions such as listing tasks, running tasks, fetching logs, and managing subscriptions. Start by ensuring your client can reach the server via either the remote HTTP endpoint or the local CLI integration, then issue the available operations through the MCP client’s standard workflow.

How to install

Prerequisites you need before you install:
- Python (for pip installation) or a runtime that supports the MCP server package
- A working Internet connection to fetch dependencies
- Access credentials for your QingLong panel (URL, Client ID, Client Secret) if you plan to query a remote instance.

Additional configuration and usage notes

Configure the MCP server client with the QingLong panel information and the appropriate credentials. Create or edit your environment file to include the QingLong URL and credentials that the MCP server will use to authenticate with QingLong.

Example client configuration

{
  "mcpServers": {
    "qinglong_http": {
      "type": "http",
      "url": "https://your-qinglong-url.com/mcp",
      "args": []
    },
    "qinglong_cli": {
      "type": "stdio",
      "command": "uvx",
      "args": ["qinglong-mcp-server"]
    }
  }
}

How to install and run locally with the CLI

To run the MCP server locally using the CLI, follow these steps to install and start the server in your environment.

Security considerations

Keep your QingLong panel credentials secure. Use separate credentials for MCP access if possible and restrict network access to the MCP endpoints to trusted clients.

Troubleshooting

If you encounter connection issues, verify that the QingLong URL is reachable from the MCP host and that credentials are correct. Check firewall rules and ensure that the MCP server process has the necessary permissions to access the QingLong panel.

Notes

The server supports querying and executing QingLong tasks, retrieving logs, checking status, listing subscriptions, and running subscriptions. Ensure you supply valid credentials and URLs for your QingLong instances.

Available tools

list_qinglong_tasks

Query and return all scheduled tasks from the QingLong panel.

run_task

Execute a specific task and wait for completion, returning logs (up to 30 seconds).

run_task_async

Start a task asynchronously without waiting for completion.

get_task_logs

Fetch the execution logs for a specified QingLong task.

get_task_status

Get the current execution status of a specified QingLong task.

list_subscriptions

List all subscriptions configured in the QingLong panel.

run_subscription

Run a specified subscription from QingLong.