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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
chenweiandClaude committed 2026-07-30 16:59:07 +00:00
1 parent 9506490ce2
commit de683fe9c2
7 files changed
+193 -11

No files matched your search

+19 -1
View File
@@ -36,6 +36,24 @@ async with PPClient.via_bridge("192.168.61.35:8971") as dev: # 经 bridge
设备操作全集:对时(tz)/模式/切换/传图/6 模板/倒计时/休眠/停车牌/轮播/LUT/WiFi/raw/OTA,
见 [`docs/sdk/API.md`](docs/sdk/API.md)。
## MCP 服务器(agent 直挂)
`ppclock-mcp` 在蓝牙物理所在机器上跑单层 MCP 服务器,13 个工具覆盖对时/模式/传图/
模板/倒计时/休眠等日常操作:
```bash
pip install -e ".[mcp]" # 追加依赖 mcp
# stdio —— Claude Code 等本机 agent 直挂
claude mcp add ppclock -- ppclock-mcp --mac AA:BB:CC:DD:EE:FF
# streamable HTTP —— 局域网 agent 平台(Bearer 鉴权,端点 /mcp)
PPCLOCK_MCP_TOKEN=<token> ppclock-mcp --transport http --host 0.0.0.0 --port 8972
```
连接管理为方案 C(按需连接+空闲保持、串行、掉线重连一次);OTA/激活/LUT/WiFi/轮播
有意不暴露。工具参考与部署指南见 [`docs/sdk/MCP.md`](docs/sdk/MCP.md)。
## CLI 用法
```bash
@@ -97,7 +115,7 @@ ppclock --json ota firmware.img --yes # SUOTA
## 开发
```bash
.venv/bin/python -m pytest tests/ -q # 165 测试
.venv/bin/python -m pytest tests/ -q # 195 测试
```
治理规则见 `GOVERNANCE.md`;变更记录 `CHANGELOG.md`;决策日志 `DECISIONS.md`。