AI业务自动化引擎

一个基于Frappe/ERPNext系统的AI业务自动化引擎,通过Web聊天或Telegram执行实际业务流程,包括文档链处理、批量记录创建、数据分析和工作流管理。

  • by Dkm0315
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Dkm0315/frappe-mcp-ui

使用说明

MCP UI——Frappe/ERPNext的人工智能业务自动化

一个位于整个Frappe/ERPNext系统之上的AI引擎。用户通过以下方式进行交互 网络聊天 或 电报 人工智能执行真实的业务流程,而不是通用的建议。

它的作用:

  • 运行完整的文档链:报价→ 销售订单→ 送货单→ 销售发票
  • 批量从Excel上传创建数百条记录
  • 运行报告并分析具有实际见解的数据
  • 管理工作流、审批和文档提交
  • 适用于每个已安装的Frappe应用程序——帮助台、CRM、ERPNext、自定义应用程序

两个通道,同一个大脑:

  • 网络聊天 (/mcp → 聊天页面)——通过Vercel AI SDK流式传输响应
  • 电报机器人 (通过OpenClaw)-相同的29个工具,相同的权限,由Frappe调度器自动管理

安装

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

许可证

麻省理工学院