快速开始
十分钟内:安装 → 激活 → 让你的第一个 AI 客户端连上本机工作区。
1. 安装(Windows)
方式一:安装向导(推荐)
下载安装程序(当前 v2.5.27,Windows 10+,免管理员)。运行 AeasyMCPServer-Setup-<版本>.exe,按向导完成安装(免管理员,装到当前用户目录)。安装完成后程序自动启动,并打开控制台窗口。
方式二:便携版
解压便携 zip 到任意目录,直接运行 aeasymcp-windows-amd64.exe。配置与数据生成在 exe 同目录下,不写注册表。
2. 打开控制面板
安装向导完成后程序已启动;便携版双击 exe 即可。浏览器打开:
http://127.0.0.1:18766/panel面板只监听本机回环地址,不会暴露到局域网。首次启动会自动打开浏览器。
3. 激活授权
购买渠道获得的 CDKey(格式 XXXX-XXXX-XXXX-XXXX)在面板「授权」页输入:
- 打开「授权」页,在输入框粘贴 CDKey;
- 点击「激活」——激活成功后 MCP 服务与内网隧道自动具备启动条件;
- 卡片会显示套餐、到期时间与剩余天数。
一张卡密绑定一台电脑(一卡一机)。离线时可继续使用(宽限期 72 小时)。
4. 添加工作空间
面板顶部「工作空间」卡片:
- 点击「添加」,输入项目目录的绝对路径(或用「浏览…」逐级选择);
- 每个工作空间会得到独立的 MCP 接入地址(URL 含 UUID)。
TIP
从哪个目录启动程序不会自动注册该目录为工作空间——工作空间只能在这里显式添加,避免误暴露主目录等敏感路径。
5. 启动服务
面板右上角开关(或 toggle 命令)启动 MCP 网关。启动后,工作空间卡片显示本地接入地址,形如:
http://127.0.0.1:18765/mcp/<uuid>6. 接入你的 AI 客户端
以 Claude Desktop 为例,在 MCP 服务器配置中加入:
json
{
"mcpServers": {
"workspace": {
"url": "http://127.0.0.1:18765/mcp/<你的工作空间UUID>"
}
}
}重启客户端,即可让它读写该工作区的文件、执行命令、查诊断。更多客户端(Cursor 等)见客户端接入。
常用命令
安装模式下命令名为 aeasymcp,便携模式直接运行 exe:
bat
aeasymcp serve :: 启动服务(前台)
aeasymcp status :: 查看运行状态
aeasymcp toggle :: 启动/停止切换
aeasymcp doctor :: 环境诊断(配置位置、端口、依赖)
aeasymcp workspace add D:\Projects\demo :: 命令行添加工作空间
aeasymcp workspace list