MCP UI——Frappe/ERPNext的人工智能业务自动化
一个位于整个Frappe/ERPNext系统之上的AI引擎。用户通过以下方式进行交互 网络聊天 或 电报 人工智能执行真实的业务流程,而不是通用的建议。
它的作用:
- 运行完整的文档链:报价→ 销售订单→ 送货单→ 销售发票
- 批量从Excel上传创建数百条记录
- 运行报告并分析具有实际见解的数据
- 管理工作流、审批和文档提交
- 适用于每个已安装的Frappe应用程序——帮助台、CRM、ERPNext、自定义应用程序
两个通道,同一个大脑:
- 网络聊天 (
/mcp→ 聊天页面)——通过Vercel AI SDK流式传输响应 - 电报机器人 (通过OpenClaw)-相同的29个工具,相同的权限,由Frappe调度器自动管理
安装```bash
bench get-app https://github.com/Dkm0315/frappe-mcp-ui --branch develop
bench --site your-site install-app mcp_ui
bench --site your-site migrate
安装程序会自动设置OpenClaw npm包。如果Node.js不可用,您可以稍后从MCP设置运行安装程序。
## 配置
首选 **MCP设置** Frappe办公桌:
**1.人工智能提供商**
- 选择提供商:OpenAI、Anthropic、谷歌或Ollama(本地)
- 设置模型(例如。 `gpt-4o-mini`, `claude-sonnet-4-6`, `qwen3:14b`)
- 输入您的API密钥(Ollama不需要)
**2.电报机器人** (可选)
- 通过以下方式创建机器人 @植物学家 在Telegram上
- 将机器人令牌粘贴到MCP设置中
- 将Telegram用户名映射到Frappe用户(控制权限)
- 启用“启用OpenClaw”复选框
**3.访问控制**
- 选择AI可以访问每个模块的哪些DocType
- 即使用户拥有Frappe权限,AI也不会触摸不在此列表中的DocTypes
**4.生成配置并启动**
- 点击 **设置OpenClaw** --安装软件包,生成配置,启动网关
- Frappe调度程序使网关自动保持活动状态(如果崩溃则重新启动)
## 运作原理
AI已经 **29工具** 涵盖每一项业务运营:
|类别|工具|
|----------|-------|
|CRUD | get_list、get_document、create_document、update_document、delete_document、search_documents|
|生命周期|提交_文档、取消_文档、修改_文档、生成_复制_文档|
|批量|批量创建、批量更新、批量删除|
|Excel |解析Excel、导入Excel、导出Excel|
|报告|运行报告、get_dashboard_data、get_count、analyze_data|
|处理| get_linkd_documents、get_workflow_info、get_ending_approvals、get_doctype_meta|
|其他|execute_automation_chain、web_search、get_module_text、get_form_guidance、get_process_chain|
每次工具调用都会执行 `frappe.has_permission()` 作为当前用户。销售代表看不到制造BOM。人力资源经理看不到其他分支机构的数据。Frappe的RBAC是自动执行的。
## 建筑```
mcp_ui/
├── ai/
│ ├── engine.py # Multi-step streaming chat (up to 25 tool rounds)
│ ├── tools.py # 29 business automation tools
│ ├── stream.py # Vercel AI SDK Data Stream Protocol
│ └── providers.py # LLM provider config via litellm
├── openclaw/
│ ├── server.py # MCP stdio server (what OpenClaw spawns)
│ └── manager.py # Process manager (start/stop/auto-restart via scheduler)
├── api/
│ ├── ai_chat.py # SSE streaming endpoint for web chat
│ └── openclaw.py # Config generator, SOUL.md generator, gateway control
└── mcp/src/
├── pages/Chat.tsx # Web chat UI with useChat()
└── components/chat/ # Rich result renderers (DataTable, ProcessChain, etc.)
需求
- Frappe框架v15+
- Python 3.10+
- Node.js v20+(用于OpenClaw网关)
- LLM提供商:OpenAI API密钥、Anthropic API密钥或本地Ollama
许可证
麻省理工学院