@atlisp/mcp 1.8.29 → 1.8.31

package/README.md

@@ -1,6 +1,6 @@
 # @lisp MCP Server
 
-MCP (Model Context Protocol) Server for @lisp on CAD — 为 CAD 环境提供 @lisp 包管理服务的 MCP 服务器，同时为 AI Agent 操控 CAD 提供 **220+ 个调用工具**和通道。
+MCP (Model Context Protocol) Server for @lisp on CAD — 为 CAD 环境提供 @lisp 包管理服务的 MCP 服务器，同时为 AI Agent 操控 CAD 提供 **230+ 个调用工具**和通道。
 
 支持 **AutoCAD / ZWCAD / GStarCAD / BricsCAD**，通过 COM 互操作与 CAD 通信。
 
@@ -189,6 +189,30 @@ atlisp-mcp --ws
 atlisp-mcp --port 9000 --host 127.0.0.1
 ```
 
+> **端口防冲突**：每个端口只允许一个实例运行。启动时自动检测端口是否已被其他 `atlisp-mcp` 进程占用（通过 `~/.atlisp/locks/atlisp-mcp-{port}.lock` PID 锁文件），占用则报错退出。不同端口可同时运行多个实例互不干扰。
+
+### 设置开机自启
+
+注册到用户登录后自动启动 HTTP 服务：
+
+```bash
+atlisp-mcp --install-autostart
+```
+
+移除自启：
+
+```bash
+atlisp-mcp --uninstall-autostart
+```
+
+查看自启状态：
+
+```bash
+atlisp-mcp --autostart-status
+```
+
+支持三种平台：Windows（Registry Run 键）、macOS（LaunchAgent）、Linux（XDG Autostart）。
+
 ### 健康检查
 
 ```bash
@@ -225,7 +249,7 @@ curl http://localhost:8110/metrics
 
 ```json
 {
-  "name": "connect_cad",
+  "name": "open_cad",
   "arguments": {}
 }
 ```
@@ -234,16 +258,26 @@ curl http://localhost:8110/metrics
 
 ```json
 {
-  "name": "connect_cad",
+  "name": "open_cad",
   "arguments": {
     "platform": "AutoCAD"
   }
 }
 ```
 
+也支持 `connect_cad` 工具（仅连接不切前台）：
+
+```json
+{
+  "name": "connect_cad",
+  "arguments": {}
+}
+```
+
 **自动行为**:
 - 如果 CAD 已运行，连接现有实例
 - 如果 CAD 未运行，通过 COM 自动创建新实例
+- `open_cad` 额外将 CAD 窗口切换到前台
 
 连接成功返回类似: `已连接到 AutoCAD 2025`
 
@@ -281,11 +315,12 @@ curl http://localhost:8110/metrics
 
 ## 工具列表 (230+)
 
-### 系统与 CAD 连接 (11)
+### 系统与 CAD 连接 (12)
 
 | 工具 | 说明 | 参数 |
 |------|------|------|
-| `connect_cad` | 连接 CAD | `platform` (可选) |
+| `open_cad` | 打开 CAD 应用并切换到前台（未运行则自动启动） | `platform` (可选) |
+| `connect_cad` | 连接 CAD（仅连接不切换前台） | `platform` (可选) |
 | `eval_lisp` | 执行 LISP 代码（无返回值） | `code` (必填) |
 | `eval_lisp_with_result` | 执行 LISP 并返回结果 | `code` (必填), `encoding` (可选) |
 | `get_cad_info` | 获取 CAD 信息 | — |
@@ -813,6 +848,9 @@ curl http://localhost:8110/metrics
 | `--config <path>` | 配置文件路径 |
 | `--ssl-key <path>` | SSL 私钥文件 |
 | `--ssl-cert <path>` | SSL 证书文件 |
+| `--install-autostart` | 注册用户登录后自动启动 HTTP 服务 |
+| `--uninstall-autostart` | 移除自动启动注册 |
+| `--autostart-status` | 查询自动启动是否已安装 |
 
 ---
 
@@ -869,7 +907,7 @@ curl http://localhost:8110/metrics
 | 中文乱码 | 使用 `encoding: gbk` 参数或用 `vl-prin1-to-string` 处理 |
 | 括号错误 | MCP Server 会自动检查并提示 |
 | CAD 未自动启动 | 检查 COM 权限，以管理员身份运行 |
-| 端口被占用 | 使用 `--port` 指定其他端口 |
+| 端口被占用 | 使用 `--port` 指定其他端口；同端口多实例冲突时，结束原进程或换端口 |
 | 全局命令找不到 | 检查 npm 全局安装路径是否在 PATH 中 |
 
 ---