buildswithpaul/Frappe_Assistant_Core

解决的问题

Frappe Assistant Core（FAC）允许用户使用自然语言与他们的ERPNext站点进行交互。它弥合了LLM（如Claude或ChatGPT）与ERPNext数据之间的差距，使用户无需手动浏览界面即可执行复杂任务，例如检索逾期发票、更新潜在客户状态或运行收入报告。

工作原理

FAC充当网关，通过模型上下文协议（MCP）公开ERPNext数据和功能。它提供24个内置工具，用于文档CRUD、搜索、报告和分析。

有两种主要使用方式：

1. BYO-LLM（MCP服务器）： 用户将支持MCP的LLM客户端（例如Claude Desktop、Cursor）连接到他们的站点。LLM使用用户自己的API密钥，数据保留在用户的堆栈中。
2. FAC聊天（SaaS）： 一种选择加入的托管体验，在Frappe Desk内提供原生聊天小部件和全屏SPA，由FAC Cloud提供支持。

身份验证通过OAuth 2.0处理，确保LLM只能根据用户的ERPNext角色访问特定用户被允许查看的数据。所有操作都记录在助手审计日志中。

面向谁

希望集成AI助手以自动化业务流程和数据检索的ERPNext/Frappe站点管理员和用户。

亮点

• MCP集成： 对模型上下文协议的原生支持，可无缝连接到外部LLM客户端。
• 实时模式访问： 直接从Frappe的API读取元数据，这意味着自定义字段和DocType无需同步即可立即对LLM可见。
• 可扩展工具集： 开发人员可以通过自己的Frappe应用中的钩子添加自己的工具和技能。
• 权限感知： 通过OAuth 2.0严格遵循ERPNext用户权限。
• 内置分析： 包括用于运行Python代码和数据库查询以进行高级数据分析的工具。