# cyou-mcp Agent Setup

> 创游世界脚本生成助手 · MCP 服务器工具链

你正在接入 cyou-mcp：一个部署在 PHP 虚拟主机上的 MCP 服务器（Streamable HTTP，协议版本 2025-06-18）。
它提供创游世界（积木式 2D 游戏创作平台）的脚本方案生成与知识库检索能力，数据源为 554 个知识片段（25 个分类）。

## 接入原则

- 无需安装任何 CLI，无需运行 shell 命令——接入就是配置一个 MCP 客户端。
- 服务器公开访问，**不需要**用户提供密码、cookie、session 或 token。
- 端点只有一个：`http://winster.xtxt.xyz/cyou-mcp/mcp.php`（HTTPS 同路径也可用）。

## 1. 接入配置

### Reasonix（config.toml）

```toml
[[plugins]]
name = "cyou-mcp"
type = "http"
url  = "http://winster.xtxt.xyz/cyou-mcp/mcp.php"
```

### 其他 MCP 客户端（Claude / Cursor / 自研等）

- 传输方式：Streamable HTTP（POST JSON-RPC；GET 为 SSE 事件流）
- 端点 URL：`http://winster.xtxt.xyz/cyou-mcp/mcp.php`
- 无需鉴权头（公开访问）

## 2. 可用工具

| 工具 | 说明 |
|---|---|
| `generate_script_scheme(requirement)` | 按需求生成创游积木脚本方案：推荐组件、架构、脚本步骤、广播命名建议、参考知识片段 |
| `search_knowledge(query, limit)` | 检索创游世界知识库（组件/触发时机/广播/变量作用域/API/常见问题） |
| `list_topics()` | 列出知识库主题目录 |

## 3. 验证接入

### 方式一：命令行快速验证（curl）

```bash
curl -X POST http://winster.xtxt.xyz/cyou-mcp/mcp.php \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"1.0"}}}'
```

### 方式二：端到端测试脚本

```powershell
python test_client.py http://winster.xtxt.xyz/cyou-mcp/mcp.php
```

预期输出 8 项全部 `PASS`。

### 方式三：浏览器

直接打开 `http://winster.xtxt.xyz/cyou-mcp/mcp.php` 会显示服务状态页（数据库状态、知识库片段数、工具列表）。

## 4. 服务信息

- 端点：`http(s)://winster.xtxt.xyz/cyou-mcp/mcp.php`
- 服务器：`cyou-mcp` v1.0.0（PHP + MySQL，香港节点）
- 知识库：554 片段 / 25 分类（编辑器入门、组件系统、触发时机、广播机制、变量作用域、API 手册、商店/背包设计等）
- 状态页：浏览器访问端点即见

## 5. 常见问题

- **浏览器打开端点一直加载？** 已修复：浏览器访问返回状态页；MCP 客户端 POST 不受影响。
- **HTTPS 不稳定？** 优先使用 HTTP 端点；HTTPS 已部署证书但偶发 TLS 重协商。
- **需要鉴权？** 当前公开访问；如需 Token 可开启（服务器 config.php 中 auth_token）。