# yuanhe-renovation-mcp

> 工程師小蘇(蘇益弘) / 沅禾裝修 — 給 AI Agent 用的裝修任務 MCP server。
> Companion site: <https://yuanhe-renovation.pages.dev/>

## Tools

### `tile_calculator`
計算磁磚數量、損耗、整箱數。

**Inputs**:
- `area` (number, 必填) — 鋪設面積數值
- `area_unit` (`"ping"` | `"m2"`, default `"ping"`) — 單位
- `tile_size` (string, 必填) — 磁磚尺寸、`寬x長` cm(例 `30x60` / `60x120` / `90x180`)
- `pattern` (`"direct"` | `"half-stagger"` | `"third-stagger"` | `"diamond"` | `"herringbone"`, default `"direct"`)
- `waste_rate` (number, 可選) — 自訂損耗率 0-0.5
- `per_box` (number, 可選) — 每箱片數

**Output**:磚數、整箱數、損耗、備品、100×100 以上大板警示、相關 web 連結。

### `list_common_tile_sizes`
列出常見磁磚規格速查表(30×30 至 90×180 共 7 種)、每箱片數、適用場景。

## Endpoints

- `GET /` — 服務說明
- `POST /mcp` — Streamable HTTP transport(建議)
- `GET /sse` — Server-Sent Events transport

## Local dev

```sh
npm install
npx wrangler dev
```

## Deploy

```sh
npx wrangler deploy
```

## Tech

Cloudflare Workers + Durable Objects + `agents/mcp` McpAgent + `@modelcontextprotocol/sdk`.

## License

MIT