docs+release: MCP.md 工具参考与部署指南；0.2.0

Co-Authored-By: Claude <noreply@anthropic.com>

llms.txt

@@ -1,6 +1,6 @@
 # ppclock — 4.2寸墨水屏设备（DA14585 BLE）离线 SDK
 
-> AI 消费向项目卡（llms.txt v0.1.0）。人用文档见 README.md；签名级 API 见 docs/sdk/API.md。
+> AI 消费向项目卡（llms.txt v0.2.0）。人用文档见 README.md；签名级 API 见 docs/sdk/API.md；MCP 服务器见 docs/sdk/MCP.md。
 
 ## 一句话
 
@@ -10,12 +10,13 @@ ppclock 是 4.2" 400×300 黑白红三色墨水屏设备（Dialog DA14585，广
 
 ```bash
 python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
-.venv/bin/python -m pytest tests/ -q   # 165 全绿
+.venv/bin/python -m pytest tests/ -q   # 195 全绿
 ```
 
 - 库：`from ppclock import PPClient`
 - CLI：`ppclock [--json] [--mac X] [--via bridge://host[:port]] <cmd>`
 - BLE 桥：`ppclock-bridge --host 0.0.0.0 --port 8971`（在他机蓝牙物理所在机运行，本机经 `--via` 透明使用）
+- MCP 服务器：`ppclock-mcp [--mac X] [--transport http --host 0.0.0.0 --port 8972]`（`PPCLOCK_MCP_TOKEN` 鉴权；extra `.[mcp]`）
 
 ## 快速示例
 
@@ -28,6 +29,8 @@ async with PPClient.via_bridge("192.168.61.35:8971", mac="18:BC:5A:5D:BF:28") as
     await dev.activate_auto()                      # 离线激活（破解厂商云）
 ```
 
+MCP 挂载（agent 直挂 13 工具）：`claude mcp add ppclock -- ppclock-mcp --mac X`，或 HTTP 端点 `http://<host>:8972/mcp` + Bearer token；详见 docs/sdk/MCP.md。
+
 ## 架构（关键不变量）
 
 1. **命令走 331f（alt 通道）**：1f1f 只 ATT-ACK 不执行（实机证据，勿用）。
@@ -38,11 +41,11 @@ async with PPClient.via_bridge("192.168.61.35:8971", mac="18:BC:5A:5D:BF:28") as
 
 ## 目录
 
-- `src/ppclock/`：client.py（门面）/ protocol / image_pipeline / templates / transports(base,local,bridge) / firmware(image,ota) / cli / bridge_server
+- `src/ppclock/`：client.py（门面）/ protocol / image_pipeline / templates / transports(base,local,bridge) / firmware(image,ota) / cli / bridge_server / ppclock-mcp（mcp_server 入口 / device_manager 连接管理 / mcp_tools 13 工具）
 - `tools/`：fw_info/fw_pack（镜像工具）、field_test（真机引导测试）、flash_run、gpio_probe、rppclock.sh（守候重试）
-- `docs/`：protocol.md（协议规范·唯一事实源）、sdk/API.md、architecture.md、firmware-analysis.md、firmware-layout.md、field-test-result.md
+- `docs/`：protocol.md（协议规范·唯一事实源）、sdk/API.md、sdk/MCP.md、architecture.md、firmware-analysis.md、firmware-layout.md、field-test-result.md
 - `analysis/`：三线逆向证据（web/apk/firmware）
-- `tests/`：165 测试
+- `tests/`：195 测试
 
 ## 设备事实（实测 NRF-5DBF28）
 
@@ -60,4 +63,4 @@ async with PPClient.via_bridge("192.168.61.35:8971", mac="18:BC:5A:5D:BF:28") as
 
 ## 版本
 
-0.1.0（CHANGELOG.md）。治理：GOVERNANCE.md（证据纪律/门禁）；历史决策：DECISIONS.md。
+0.2.0（CHANGELOG.md）。治理：GOVERNANCE.md（证据纪律/门禁）；历史决策：DECISIONS.md。