ec-build-mcp

EC-Build MCP Server with stdio transport - 本地构建，云端部署

安装

npx ec-build-mcp

本地开发测试

1. 构建项目

cd mcp-stdio
npm install
npm run build

2. 在 Cursor 中配置本地 MCP

打开 Cursor 设置 → MCP，编辑配置文件（通常是 ~/.cursor/mcp.json 或通过 GUI 编辑），添加：

方法 A：使用 node 直接运行（推荐）

{
  "mcpServers": {
    "ec-build-local": {
      "command": "node",
      "args": ["/Users/shaoyun/workdir/ec-build/mcp-stdio/dist/index.js"],
      "env": {
        "EC_BUILD_SERVER": "http://localhost",
        "EC_BUILD_TOKEN": "your_token_here"
      }
    }
  }
}

方法 B：使用本地 bin 脚本

{
  "mcpServers": {
    "ec-build-local": {
      "command": "/Users/shaoyun/workdir/ec-build/mcp-stdio/bin/ec-build-mcp",
      "env": {
        "EC_BUILD_SERVER": "http://localhost",
        "EC_BUILD_TOKEN": "your_token_here"
      }
    }
  }
}

环境变量说明：

• EC_BUILD_SERVER: EC-Build 服务器地址
  • 本地测试：http://localhost（连接本地开发服务器）
  • 生产环境：https://ec-build.io 或省略此配置项（使用默认值）
• EC_BUILD_TOKEN: 你的 EC-Build API Token（从 Web 界面获取）

注意：

• 将路径 /Users/shaoyun/workdir/ec-build/mcp-stdio 替换为你的实际项目路径
• 本地测试时，确保 EC-Build 后端服务已启动（cd backend && uv run uvicorn app.main:app --reload）
• 配置后重启 Cursor 或刷新 MCP 连接

3. 验证连接

在 Cursor 中打开 MCP 面板，应该能看到 ec-build-local 服务和以下工具：

• ecbuild_init - 初始化项目
• ecbuild_build_deploy - 构建并部署
• ecbuild_status - 查看部署状态
• ecbuild_logs - 查看部署日志
• ecbuild_list - 列出所有项目

4. 开发模式（实时编译）

如果需要修改代码并实时测试：

# 终端 1：启动实时编译
npm run dev

# Cursor 会自动重载 MCP 连接，或手动刷新 MCP

生产环境配置

发布到 npm 后，在 Cursor 中配置：

{
  "mcpServers": {
    "ec-build": {
      "command": "npx",
      "args": ["ec-build-mcp"],
      "env": {
        "EC_BUILD_SERVER": "https://ec-build.io",
        "EC_BUILD_TOKEN": "your_token_here"
      }
    }
  }
}

注意： 生产环境中 EC_BUILD_SERVER 可以省略（默认就是 https://ec-build.io）

使用

1. 初始化项目: ecbuild_init
2. 构建部署: ecbuild_build_deploy
3. 查看状态: ecbuild_status

文档

• 使用指南
• 发布到 npm