# 青龙面板 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（整数）
