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端点存在且权限配置正确。