工作空间
工作空间(workspace)是暴露给 AI 客户端的一个项目目录:该目录内的文件读写、命令执行、搜索诊断全部开放,目录之外默认只读或不可见。每个工作空间有独立的 UUID 接入地址。
添加与移除
面板(推荐):顶部「工作空间」卡片 → 「添加」→ 输入绝对路径或「浏览…」逐级选择(支持新建文件夹),可填显示名。
命令行:
bat
aeasymcp workspace add D:\Projects\demo
aeasymcp workspace list
aeasymcp workspace remove <uuid>至少保留一个工作空间;移除操作不会删除磁盘上的任何文件。
管理操作
每个工作空间条目支持:
- 启用 / 停用:停用后其
/mcp/<uuid>返回 404,客户端无法接入;重新启用即恢复; - 重命名:只改显示名,接入 URL 不变;
- 改目录:把工作空间指向新目录但保留 UUID——客户端里的配置地址无需修改;
- 删除:从注册表移除(文件不受影响)。
所有改动即时生效,服务运行期间无需重启。
不会自动注册启动目录
**从任意目录启动程序(包括双击、主目录、桌面)都不会把该目录注册为工作空间。**工作空间只能通过面板、workspace add 或显式参数添加:
bat
:: 显式指定并注册一个工作空间(明确意图时使用)
aeasymcp serve -workspace D:\Projects\demo这是有意为之的安全设计:避免误把主目录等敏感路径暴露给 AI 客户端。
单实例行为
服务已在运行时,再次运行程序:
- 不带参数:提示已有实例与面板地址后退出,不会注册当前目录,也不会启动竞争实例;
- 带
-workspace <路径>:把该目录转发给运行中的实例注册并打印接入地址; -new-instance:强制启动独立副本(测试新版本用;端口冲突会明确报错)。
多工作区如何工作
所有已注册工作空间共享同一个监听端口(默认 18765),按 UUID 路由:
http://127.0.0.1:18765/mcp/<uuid-A> → 工作空间 A
http://127.0.0.1:18765/mcp/<uuid-B> → 工作空间 B- 给不同 AI 客户端(或同一客户端的不同会话)分配不同工作空间,权限天然隔离;
- 未知 UUID 返回 404;
- 公网模式下,每个工作空间是独立可回收的路由(见公网访问),等级决定最少保留数。