Metadata-Version: 2.4
Name: qinglong-mcp-server
Version: 0.1.2
Summary: MCP server for Qinglong Panel task management
Author-email: Your Name <your.email@example.com>
License: MIT
Keywords: automation,mcp,qinglong
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Requires-Dist: python-dotenv
Requires-Dist: requests
Description-Content-Type: text/markdown

# 青龙面板 MCP Server

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

## 功能

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

## 安装

```bash
pip install -r requirements.txt
```

## 配置

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

```bash
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`）：

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

### 测试工具

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

```bash
./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（整数）
