# Wardrobe MCP 服务说明

MCP (Model Context Protocol) 服务提供衣物管理平台数据管理接口，供 AI 助手、外部系统进行数据 CRUD 操作。

## 架构

```
┌─────────────┐    IPC (Tauri invoke)    ┌──────────────┐
│ Web 前端     │ ───────────────────────▶ │ Rc MCP Service│
└─────────────┘                          └──────┬───────┘
                                                │
                                        ┌───────▼───────┐
                                        │ DuckDB        │
                                        │ wardrobe.duckdb│
                                        └───────────────┘
```

MCP 服务通过 Tauri 的 `mcp_list_tools` / `mcp_call_tool` 命令暴露，前端或其他 Tauri 插件可通过 `invoke` 调用。

## 可用工具列表

### 衣物管理

| 工具 | 描述 | 必需参数 |
|------|------|----------|
| `list_clothing` | 获取用户衣橱衣物列表 | `user_id`, 可选 `category` |
| `get_clothing` | 获取单品详情 | `id` |
| `add_clothing` | 添加衣物 | `user_id`, `name`, `category`, `color` |
| `update_clothing` | 更新衣物 | `id`, 可选 `name`/`category`/`color` |
| `delete_clothing` | 删除衣物 | `id` |

### 搭配管理

| 工具 | 描述 | 必需参数 |
|------|------|----------|
| `list_outfits` | 获取搭配列表 | `user_id` |
| `add_outfit` | 创建搭配方案 | `user_id`, `name`, `item_ids[]` |

### 穿搭记录

| 工具 | 描述 | 必需参数 |
|------|------|----------|
| `record_daily_outfit` | 记录每日穿搭 | `user_id`, `date` (YYYY-MM-DD) |
| `list_daily_records` | 获取穿搭日历 | `user_id`, 可选 `limit` |

### 统计

| 工具 | 描述 | 必需参数 |
|------|------|----------|
| `get_wardrobe_stats` | 衣橱统计数据 | `user_id` |

## 调用示例

### 列出用户衣物

```json
{
  "tool_name": "list_clothing",
  "args": { "user_id": "uuid-xxx", "category": "top" }
}
```

### 添加衣物

```json
{
  "tool_name": "add_clothing",
  "args": {
    "user_id": "uuid-xxx",
    "name": "白色衬衫",
    "category": "top",
    "color": "#FFFFFF",
    "brand": "优衣库",
    "seasons": ["春", "夏"],
    "occasions": ["通勤"]
  }
}
```

### 获取统计

```json
{
  "tool_name": "get_wardrobe_stats",
  "args": { "user_id": "uuid-xxx" }
}
```

返回:
```json
{
  "total_items": 42,
  "total_outfits": 15,
  "utilization_rate": 73.0,
  "category_counts": { "top": 12, "bottom": 8, "outer": 6, "dress": 5, "shoes": 6, "accessory": 5 },
  "favorite_count": 3,
  "unworn_30d": 2,
  "needs_cleaning": 2
}
```

## 整合到 AI 客户端配置

在 AI 客户端 (如 Claude, Cursor) 的 MCP 配置中添加:

```json
{
  "mcpServers": {
    "wardrobe": {
      "command": "npx",
      "args": ["-y", "@wardrobe/mcp-server"],
      "env": { "WARDROBE_DB_PATH": "path/to/wardrobe.duckdb" }
    }
  }
}
```

> 注: 当前版本 MCP 通过 Tauri IPC 暴露，AI 客户端集成需将 `McpService` 包装为标准 MCP stdio server。`src-tauri/src/mcp.rs` 中 `list_tools` / `call_tool` 已实现会话无关的纯逻辑接口，可直接复用。

## 认证

验证码暂统一为 `1111`。注册/登录流程:

1. `send_code(target)` - 发送验证码 (target 为邮箱或手机号)
2. `register(email|null, phone|null, code, nickname)` - 注册
3. `login(email|null, phone|null, code)` - 登录

验证码有效期 5 分钟，成功后自动失效。