EasyClick MCP Server：让 AI IDE 成为自动化脚本开发专家

一、项目简介

项目	说明
名称	EC-MCP Server
定位	EasyClick 自动化开发专用 MCP 服务端
技术栈	Rust + Salvo + rmcp SDK + SQLite
版本	v1.2.0
平台	Windows / macOS (Universal Binary)

EC-MCP Server 是一款面向 EasyClick 全平台自动化开发的 AI 增强服务，通过标准 MCP 协议为 Trae、Cursor 等 AI IDE 提供完整的 EC 开发能力。

项目旨在解决传统 AI 写 EC 脚本出现的 API 幻觉、代码不规范、平台适配混乱、缺少官方开发范式 等问题，让 AI 完全按照 EC 官方体系进行标准化开发。

二、核心功能

1. 内置 33 个 EasyClick 专业工具集

服务内置完整 EC 开发工具矩阵，覆盖文档查询、平台底座、业务开发、代码规范、UI 开发、CLI 指南、取色工具、记忆系统、问题库全链路能力。

类别	工具名称	功能说明
知识查询	EasyClick_QueryDocs	精准查询 EC 官方 API 文档、技能索引、场景示例
平台底座	EasyClick_LoadAndroidBase	加载 Android 平台开发规范、API 约束、运行范式
	EasyClick_LoadiOSBase	加载 iOS 平台专属开发底座与适配规则
	EasyClick_LoadHarmonyBase	加载鸿蒙平台完整开发规范与能力边界
开发技能	EasyClick_DevelopAndroid	Android 基础自动化脚本开发、控件操作、流程编写
	EasyClick_DevelopAndroidPro	Android 高阶能力：图色识别、YOLO 视觉、HID 高精度操控
	EasyClick_DevelopiOS	iOS 全流程脚本开发、页面适配、手势模拟
	EasyClick_DevelopHarmony	鸿蒙应用自动化开发与适配
代码规范	EasyClick_GlobalRules	全局强制编码规则，统一项目代码风格
	EasyClick_DevGuide	通用开发指南、最佳实践、避坑规范
	EasyClick_CheckBible	代码圣经校验，自动排查不规范写法、过期 API、风险代码
UI 相关	EasyClick_BuildAndroidUI	快速生成 Android XML UI 布局代码
	EasyClick_BuildUI	通用 UI 结构实现与布局适配
	EasyClick_UIDesign	UI 设计规范、交互逻辑、适配标准
CLI 指南	EasyClick_AndroidCLIGuide	Android 端 CLI 命令使用指南、打包、部署、调试
	EasyClick_iOSCLIGuide	iOS CLI 全套使用规范
	EasyClick_HarmonyCLIGuide	鸿蒙 CLI 工具链完整文档
取色工具	EasyClick_PickCrop	截图、取色、框选裁剪、多点找色自动格式化
记忆系统	EasyClick_Recall	读取当前项目历史开发记忆、过往逻辑、参数配置
	EasyClick_Remember	AI 自动记录阶段性开发成果、逻辑决策、关键参数
	EasyClick_Forget	手动/自动清理无效记忆，避免上下文污染
问题库	EasyClick_SearchIssues	检索历史报错库，智能匹配已有解决方案
	EasyClick_ReportIssue	自动沉淀新问题，持续扩充问题知识库

2. 全自动记忆系统

• AI 每完成一个开发阶段自动写入记忆快照

• 新开会话自动召回当前项目的历史逻辑、参数、结构

• 支持项目隔离记忆，多项目开发互不干扰

• 支持记忆归档、清理、回溯复盘

3. 问题沉淀积累机制

• 内置 22 条高频预置问题方案库

• 遇到报错优先检索历史方案，减少重复踩坑

• 新问题解决后自动入库沉淀，持续自我迭代

• 让 AI 越用越适配 EC 生态

4. 集成截图取色裁剪工具

• 左键精准取色，自动输出 EC 标准颜色格式

• 右键框选截图、裁剪区域

• 自动生成单点/多点找色模板代码

• 完整支持 Windows / macOS 双平台

三、技术架构

整体采用分层解耦架构，基于 Rust 高性能异步服务构建，底层依托 Salvo 网络框架、标准 rmcp 协议 SDK、SQLite 本地持久化数据库。

┌─────────────────────────────────────────┐
│           AI IDE (Trae/Cursor)          │
│         MCP Client (stdio/HTTP)         │
└─────────────────┬───────────────────────┘
                  │
┌─────────────────▼───────────────────────┐
│         EC-MCP Server (Rust)            │
├─────────────────────────────────────────┤
│  ┌─────────┐  ┌─────────┐  ┌─────────┐ │
│  │ Salvo   │  │  rmcp   │  │ SQLite  │ │
│  │  Web    │  │  MCP    │  │  DB     │ │
│  └─────────┘  └─────────┘  └─────────┘ │
├─────────────────────────────────────────┤
│  ┌─────────────────────────────────────┐│
│  │     33 个 EasyClick 工具            ││
│  │  (平台底座 + 开发技能 + 代码规范)    ││
│  └─────────────────────────────────────┘│
└─────────────────────────────────────────┘

四、快速开始

Windows 启动

# 解压
unzip ec-mcp-server-v1.2.0-windows.zip -d ec-mcp-server
cd ec-mcp-server

# 运行
ec-mcp-server.exe

macOS 启动

# 解压
unzip ec-mcp-server-v1.2.0-mac-universal.zip -d ec-mcp-server
cd ec-mcp-server

# 添加执行权限
chmod +x ec-mcp-server pick-crop-tool

# 运行
./ec-mcp-server

五、AI IDE 配置（Trae / Cursor）

在 IDE 的 MCP 配置文件中加入如下配置即可完成对接：

{
  "mcpServers": {
    "ec-mcp-server": {
      "command": "/path/to/ec-mcp-server"
    }
  }
}

六、传输模式说明

模式	触发条件	使用场景
stdio	stdin 被管道化	IDE 自动托管、后台常驻运行
HTTP	stdin 为终端交互	手动调试、局域网多设备访问、二次开发

七、安全特性

• read_resource 路径穿越防护：杜绝任意文件读取漏洞

• FTS5 查询注入防护：数据库检索防注入、防恶意 payload

• 可配置端点认证：支持自定义密钥鉴权，防止未授权调用

八、版本迭代记录

版本	日期	主要更新内容
v1.2.0	2026-07-03	集成独立取色裁剪工具、完善视觉开发链路
v1.1.0	2026-07-01	全局安全漏洞修复、核心代码重构、稳定性升级
v1.0.1	2026-07-01	首个正式版本发布，完整 33 工具体系落地

九、总结

EC-MCP Server 是目前行业内 最完整、最体系化、最贴合 EasyClick 官方生态 的 AI 智能体服务。它彻底解决了通用 AI 写自动化脚本乱造 API、不规范、不区分平台、不懂工程体系的痛点，让 AI IDE 真正成为专业的自动化开发工具。