@atlisp/mcp 1.0.18 → 1.0.20

package/README.md

@@ -113,6 +113,15 @@ curl http://localhost:8110/health
 
 返回 `{"status":"ok","cad":"connected"}` 表示服务正常。
 
+### HTTP 端点
+
+| 端点 | 方法 | 说明 |
+|------|------|------|
+| `/health` | GET | 健康检查 |
+| `/sse` | GET | SSE 长连接端点（需 ENABLE_SSE=true） |
+| `/mcp/sse` | GET/POST | SSE MCP 端点（需 ENABLE_SSE=true） |
+| `/mcp` | POST | MCP JSON-RPC 端点（主要接口） |
+
 ---
 
 ## 四、连接 CAD
@@ -246,6 +255,69 @@ curl http://localhost:8110/health
 | `get_function_usage` | 获取函数用法 | `name`: 函数名 |
 | `list_functions` | 列出所有函数 | 无 |
 
+### MCP 方法
+
+| 方法 | 说明 |
+|------|------|
+| `initialize` | 初始化连接 |
+| `tools/list` | 列出工具 |
+| `tools/call` | 调用工具 |
+| `resources/list` | 列出资源 |
+| `resources/read` | 读取资源 |
+| `resources/subscribe` | 订阅资源变更 |
+| `resources/unsubscribe` | 取消订阅 |
+
+### MCP 资源
+
+| URI | 说明 |
+|-----|------|
+| `atlisp://cad/info` | CAD 连接信息（可订阅） |
+| `atlisp://cad/layers` | 图层列表（可订阅） |
+| `atlisp://cad/entities` | 实体统计（可订阅） |
+| `atlisp://dwg/name` | 当前文件名（可订阅） |
+| `atlisp://dwg/path` | 文件完整路径（可订阅） |
+| `atlisp://packages` | 包列表（可订阅） |
+| `atlisp://platforms` | 平台信息 |
+
+### 资源访问方式
+
+使用 `resources/read` 方法：
+
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "resources/read",
+  "params": {
+    "uri": "atlisp://cad/info"
+  }
+}
+```
+
+返回示例：
+```json
+{
+  "contents": [{
+    "uri": "atlisp://cad/info",
+    "mimeType": "application/json",
+    "text": "{\"connected\":true,\"platform\":\"AutoCAD\",\"version\":\"24.1\",\"busy\":false}"
+  }]
+}
+```
+
+**带参数的资源：**
+
+```json
+// 查询特定图层
+{ "uri": "atlisp://cad/layers?name=0" }
+
+// 查询特定实体类型
+{ "uri": "atlisp://cad/entities?type=LINE" }
+
+// 过滤包列表
+{ "uri": "atlisp://packages?name=base" }
+```
+
 ---
 
 ## 七、环境变量
@@ -257,6 +329,50 @@ curl http://localhost:8110/health
 | `HOST` | `0.0.0.0` | HTTP 模式监听地址 |
 | `MESSAGE_TIMEOUT` | `60000` | 消息超时（毫秒） |
 | `MCP_API_KEY` | (无) | API Key 认证（可选） |
+| `ENABLE_SSE` | `true` | 启用 SSE 模式（默认启用） |
+
+### 启用 SSE 模式
+
+SSE (Server-Sent Events) 模式默认启用，提供长连接推送能力，适合需要实时响应的场景。
+
+**禁用 SSE：**
+
+```bash
+# Windows PowerShell
+$env:ENABLE_SSE="false"; atlisp-mcp
+
+# 或命令行
+ENABLE_SSE=false atlisp-mcp
+```
+
+**SSE 端点：**
+
+| 端点 | 方法 | 说明 |
+|------|------|------|
+| `/sse` | GET | 建立 SSE 连接，返回消息端点 `/message` |
+| `/mcp/sse` | GET | 同上 |
+| `/message` | POST | 发送 JSON-RPC 请求，响应通过 SSE 推送 |
+
+**SSE 连接流程：**
+
+```
+1. 客户端 → GET /sse
+   Header: Accept: text/event-stream
+   
+2. 服务器 → 返回 SSE 流，包含:
+   event: endpoint
+   data: {"path": "/message"}
+   event: capabilities
+   data: {...}
+
+3. 客户端 → POST /message
+   Header: mcp-session-id: <session-id>
+   Body: {"jsonrpc":"2.0","id":1,"method":"tools/call",...}
+
+4. 服务器 → 通过 SSE 推送响应:
+   event: message
+   data: {"jsonrpc":"2.0","id":1,"result":{...}}
+```
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@atlisp/mcp",
-    "version": "1.0.18",
+    "version": "1.0.20",
     "description": "MCP Server for @lisp on CAD",
     "type": "module",
     "bin": {
@@ -40,6 +40,7 @@
         "@modelcontextprotocol/sdk": "^1.0.0",
         "edge-js": "^25.0.1",
         "express": "^5.2.1",
+        "express-rate-limit": "^7.1.0",
         "iconv-lite": "^0.6.3",
         "raw-body": "^3.0.0"
     },