From 12fa9581916912d600536afb3297a6405b7b2e11 Mon Sep 17 00:00:00 2001
From: JunWang <wangjun@atomdancing.com>
Date: Sun, 7 Jun 2026 12:00:26 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=E9=A1=B9=E7=9B=AE?=
 =?UTF-8?q?=E7=BA=A7=20CLAUDE.md=20=E8=AF=B4=E6=98=8E=E6=96=87=E4=BB=B6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

记录 API 地址和 MCP 能力限制规则：
- OpenAPI 地址: localhost:8088
- 仅提供只读查询能力，不允许写入接口

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 CLAUDE.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..a44ef07
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,35 @@
+# TLBM MCP Server
+
+无人车运营 API 的 MCP 封装项目。
+
+## API 配置
+
+- **OpenAPI 地址**: `http://localhost:8088/v3/api-docs`
+- **线上服务地址**: `https://www.atomdancing.com/pm`
+
+## MCP 能力限制
+
+**重要：本项目仅提供只读查询能力，不暴露任何写入类接口。**
+
+### 不允许的 MCP 能力
+- 绑定车辆到订单
+- 注册用户
+- 微信登录/获取手机号
+- 内部管理接口（重新聚合、状态推导等）
+- 任何 POST/PUT/DELETE 操作
+
+### 允许的 MCP 能力
+- 车辆状态查询（实时状态、不可用统计、工作时长、行驶距离）
+- 车辆轨迹回放
+- 运单监控（超时查询）
+- 订单查询（运单汇总、分页查询）
+- 用户查询（角色、OpenID查询）
+
+## 同步 API 更新
+
+如需同步最新 API，执行：
+```bash
+curl http://localhost:8088/v3/api-docs
+```
+
+仅提取 GET 方式的查询接口，遵循只读原则。
\ No newline at end of file