EC-Build MCP Server with stdio transport
EC-Build MCP Server - 通过 Cursor IDE 实现本地构建,云端部署
> MCP (Model Context Protocol) 是一个标准化协议,让 AI 助手能够安全地访问外部工具和数据源。此 MCP 服务器为 Cursor IDE 提供 EC-Build 部署平台的集成能力。
打开 Cursor 设置 → MCP,编辑配置文件 (通常是 ~/.cursor/mcp.json),添加以下配置:
``json`
{
"mcpServers": {
"ec-build": {
"command": "npx",
"args": ["-y", "ec-build-mcp"],
"env": {
"EC_BUILD_TOKEN": "your_token_here"
}
}
}
}
登录 EC-Build Web 界面,在用户设置中生成 API Token,并替换上面配置中的 your_token_here。
配置完成后,重启 Cursor 或在 MCP 面板中刷新连接。
在 Cursor 的 MCP 面板中,应该能看到 ec-build 服务和以下可用工具:
- ecbuild_init - 初始化新项目
- ecbuild_build_deploy - 构建并部署项目
- ecbuild_status - 查看部署状态
- ecbuild_logs - 查看部署日志
- ecbuild_list - 列出所有项目
| 变量名 | 说明 | 默认值 | 是否必需 |
|--------|------|--------|----------|
| EC_BUILD_TOKEN | API 认证令牌 | - | 是 |EC_BUILD_SERVER
| | 服务器地址 | https://ec-build.io | 否 |
生产环境配置示例 (可省略 EC_BUILD_SERVER):
`json`
{
"mcpServers": {
"ec-build": {
"command": "npx",
"args": ["-y", "ec-build-mcp"],
"env": {
"EC_BUILD_TOKEN": "your_production_token"
}
}
}
}
配置完成后,在 Cursor 中与 Claude 对话即可轻松完成部署。以下是常见场景的对话示例:
在项目目录中,对 Claude 说以下任意一句:
``
"帮我初始化这个项目到 EC Build"
或
``
"用 EC Build 部署这个项目,自动检测配置"
Claude 会自动:
- 检测项目类型(React、Vue、Next.js 等)
- 识别构建命令和输出目录
- 创建项目并保存配置到本地
初始化后,随时可以部署:
``
"构建并部署这个项目"
或者更简洁:
``
"部署"
Claude 会自动:
1. 使用已保存的配置
2. 执行本地构建 (npm run build 等)
3. 上传构建产物
4. 部署到云端
5. 返回可访问的 URL
``
"查看最新的部署状态"
``
"显示部署日志"
``
"这个项目有哪些部署记录?"
``
"显示当前 EC Build 配置"
``
"列出我所有的 EC Build 项目"
- 记忆功能:初始化后,项目配置自动保存在 ~/.ecbuild/,Claude 会记住你的项目设置
- 上下文理解:在项目目录中对话时,Claude 自动识别当前项目
- 自然语言:不需要记忆命令,用自然语言描述需求即可
- 错误处理:遇到问题时,Claude 会给出具体的解决建议
如果你需要修改或调试 MCP 服务器代码,可以使用本地开发模式。
`bash克隆项目 (或下载源码)
git clone
cd ec-build/mcp-stdio
$3
编辑 Cursor 的 MCP 配置文件,添加本地开发配置:
方式 A:使用 node 直接运行编译产物 (推荐)
`json
{
"mcpServers": {
"ec-build-local": {
"command": "node",
"args": ["/mcp-stdio/dist/index.js"],
"env": {
"EC_BUILD_SERVER": "http://localhost:8000",
"EC_BUILD_TOKEN": "your_token_here"
}
}
}
}
`方式 B:使用 bin 脚本
`json
{
"mcpServers": {
"ec-build-local": {
"command": "/mcp-stdio/bin/ec-build-mcp",
"env": {
"EC_BUILD_SERVER": "http://localhost:8000",
"EC_BUILD_TOKEN": "your_token_here"
}
}
}
}
`注意:
- 将
替换为你的实际项目绝对路径
- 本地测试时,确保 EC-Build 后端服务已在 http://localhost:8000 启动
- 配置后需要重启 Cursor 或刷新 MCP 连接$3
启用实时编译,每次代码修改后自动重新构建:
`bash
npm run dev
`修改代码后,在 Cursor 的 MCP 面板中手动刷新连接,或重启 Cursor 以加载最新代码。
$3
- 查看 MCP 服务器日志:在 Cursor 的 MCP 面板查看连接状态和错误信息
- 测试 API 连接:确保
EC_BUILD_SERVER 和 EC_BUILD_TOKEN 配置正确
- 使用 console.error() 输出调试信息 (会显示在 Cursor 的 MCP 日志中)故障排查
$3
1. 检查
EC_BUILD_TOKEN 是否有效
2. 验证网络连接(能否访问 EC_BUILD_SERVER)
3. 查看 Cursor 的 MCP 日志面板获取详细错误信息$3
1. 确认后端服务已启动:
curl http://localhost:8000/health
2. 检查路径配置是否正确(必须使用绝对路径)
3. 验证编译产物存在:ls dist/index.js技术规格
- 协议: Model Context Protocol (MCP) stdio transport
- 运行时: Node.js 18+
- 包管理: npm / npx
- TypeScript: 5.0+
更新日志
$3
- 正式发布到 npm
- 支持通过 npx ec-build-mcp` 安装- EC-Build 平台: https://ec-build.io (即将上线)
- MCP 协议规范: https://modelcontextprotocol.io
- 问题反馈: 如遇到问题,请在项目中提交 Issue
---
开源协议: MIT
维护状态: 活跃开发中