Frappe MCP Server

为Frappe框架AI助手提供REST API集成的MCP协议工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Frappe MCP Server。
它的用途是:为Frappe框架AI助手提供REST API集成的MCP协议工具
详细介绍见:https://321skill.com/skills/frappe-mcp-server/
请根据该页面的说明完成安装。

使用示例

“帮我查一下最近一周创建的销售订单列表,并计算总金额。” 它会通过配置好的Frappe MCP工具,调用对应的“Sales Order”API,获取数据并进行汇总计算后返回给你。或者,你可以说:“在ERPNext里为客户‘ABC公司’创建一个新的联系人。” AI便会使用创建Contact的工具,引导你填写必要信息并提交。

介绍

这个Skill解决了Frappe框架开发者希望将AI助手(如Claude)深度集成到其应用生态中的问题。它通过实现MCP(Model Context Protocol)协议,将Frappe的REST API封装成标准化的工具,使得AI助手能够安全、便捷地调用后端数据与业务逻辑。

使用时,开发者需要在自己的Frappe环境中部署此MCP Server,并在AI助手(如Claude Desktop)的配置中将其添加为一个MCP资源。配置完成后,AI助手便能在对话中直接调用定义好的API工具,实现查询数据、创建文档、执行业务流程等操作。

它非常适合正在使用或开发基于Frappe框架(如ERPNext)应用的后端开发、全栈开发和运维工程师。这些角色需要在开发、调试或日常运维中,通过自然语言快速与复杂的业务系统进行交互。

建议在部署前仔细规划需要暴露给AI的API端点,并遵循最小权限原则。由于涉及业务系统访问,务必在生产环境配置好身份验证与授权机制,并注意监控AI的API调用情况,防止误操作。

核心特点

这是专为Frappe/ERPNext生态设计的MCP工具,将框架内复杂的DocType、权限和工作流直接映射为AI可操作的工具,而非通用的HTTP请求工具。它深度利用Frappe的Meta API,能自动处理会话(Session)管理和Frappe特定的错误响应格式。

注意事项

仅适用于Frappe框架环境,不适合非Frappe项目或需要直接操作其他类型API的场景。

常见问题

这个工具和直接让AI调用API有什么区别?

它通过MCP协议提供了标准化、类型安全且带描述的接口,AI能更准确地理解和使用,同时内置了Frappe的认证和会话管理,更安全便捷。

我需要修改我的Frappe应用代码来使用它吗?

通常不需要,它通过Frappe现有的REST API工作。但你需要确保目标API端点存在且权限配置正确。