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_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. 验证编译产物存在：技术规格
- 协议: Model Context Protocol (MCP) stdio transport
- 运行时: Node.js 18+
- 包管理: npm / npx
- TypeScript: 5.0+
更新日志
$3
- 正式发布到 npm
- 支持通过 - EC-Build 平台: https://ec-build.io (即将上线)
- MCP 协议规范: https://modelcontextprotocol.io
- 问题反馈: 如遇到问题，请在项目中提交 Issue
---
开源协议: MIT
维护状态: 活跃开发中