@casys/mcp-erpnext

中文文档

3.5.0发布于 2026/11/05MITES Module零依赖近 30 天下载 4930

带有交互式 UI 查看器的 MCP ERPNext 服务器

文档目录22 节

截图
怎么样
文档
快速启动
先决条件
克洛德桌面/克洛德代码(npm)
VS 代码副驾驶
德诺( stidio)
HTTP 模式
类别过滤
新建实例设置
UI 查看器
导航与活动上下文
刷新模式
构建 UI 查看器
购买证据抓取
工具
环境变量
建筑
npm 软件包
捐款
许可证

@casys/mcp-erpnext (英语)

[大 安装3.3: npm/节点使用 npx -y @casys/mcp-erpnext@latest; 用于禁用 deno run -A jsr:@casys/[email protected]/server3.5.0为稳定释放并携带npm's latest 标签; 预发版, 当发布时, 使用该 next 标记。3.3 在活动上下文中添加分级选择:列表复选框,在已过滤行上全部选择,单击 Shift 范围 Ctrl/Cmd-点击切换器,一到三个选择的紧凑记录, 最多8个和1个 erpnext_doc_list 查询项目. 图表点击其列中最近的点。用MCP测试在替换已有的部署之前, 运行您的用户。见变化为释放历史.

让任何兼容 MCP 的 AI 代理操作您下一步编号 : Frappe 实例——主机内的文件,工作流程和交互式取景器 (克洛德桌面,克洛德代码,VS代码副驾驶,或自定义).

与 自动托管 财务报告和审定财务报表 下个云 (frappe.cloud)实例.

建造在 @ mcpview/ 服务器 - 多边协商进程赋予此权限的服务器框架( 货币、认证、 MCP Apps、可观察性) 项目。见 mcpview.dev (英语)。。。 .

截图

完全由工具驱动的 MCP 主机内部的交互式查看器结果.

_{doclist-查看器任意 DocType 作为可排序的表格,带有芯片过滤器和内置细节面板}	_{发票查看器 - 与当事方的发票、细列项目、项目钻入和提交/终止/付款}
_{漏斗查看器 - 领先-机会-引言-按换算率排列}	_{kpi- 查看器 - 大数字的KPI,带有三角洲对上期和火花线}
_{图表查看器 ——通用Recharts渲染器(此处:库存水平)}	_{库存查看器 ——有色码数量徽章的库存平衡}
_{kanban 查看器 — 读写板( 任务 / 机会 / 问题) , 内置编辑}	_{图表查看器 ——由两轴组成的图(此处:损益)}

怎么样

3.2.0是稳定的释放. 所有9名观众在视野内浏览背面和面包屑导航, 和确认的文件更改标志衍生的关卡已停滞, 直至再次读取。活动背景选择封面交互式查看器,以及图表、 KPI 和嵌入图细节从 a 打开触摸屏幕上的可见按钮。通用文档查看器、儿童表格和附件工作流程遵循ERPNext自己的DocType元数据. 工具选择过滤器ERPNEXT_CATEGORIES, (中文(简体) ), ERPNEXT_EXCLUDE_CATEGORIES, (中文(简体) ), ERPNEXT_EXCLUDE_TOOLS() 限制部署曝光、附件下载的内容拒绝不宣布MCP Apps的客户,错误的结构. 浏览器浓缩(更新请求、导航跳跃、工具清单) 内 _meta,出自模型上下文,而不是结果文本.

3.2.0 还载有创建-错误指导,即ERPN ext 16机会兼容性、日历日期、 KPI 百分比和漏斗货币修正 3.0.5和3.1.0 释放。特征仍然由多边方案方案确定东道主; 购买证据不购买或限定实时企业资源规划系统.

用于稳定的npm设施 @casys/mcp-erpnext@latest; 用于代诺 jsr:@casys/[email protected]/server。。。 .

见变化完全释放历史,或最新发布页:1 当前版本的要闻.

见 3.0至3.1 移徙指南联合国源合同、东道方要求和部署限额已计入3.2 在从 3.0 升级或从稳定的 3.1.0 升级时适用.

文档

由你的行为组织,跟随税制数字 :


学习从来没有使用过这个之前	你的第一个工具呼叫 - 从无到有四个步骤的工作反应
这样做你有一个特定的目标	种子为空白的 ERPN ext 实例 • 妇女运行 HTTP 服务器 • 妇女设置 OAuth • 妇女从 3.0 移到 3.1 • 妇女迁移到2026-07-28
正在寻找一些东西	工具 • 妇女环境变量 • 妇女 DocType 覆盖范围
理解为什么	概念 ——链接分辨率,传输,MRTR,以及哪些缓存会做什么.. 下一步

快速启动

先决条件

在 ERPNext 中生成 API 证书 :

登录到 ERPNext → 右上方菜单 → 我的设置
节次 API 访问 → 生成密钥
复制 API Key 财务报告和审定财务报表 API Secret

克洛德桌面/克洛德代码(npm)

{
  "mcpServers": {
    "erpnext": {
      "command": "npx",
      "args": ["-y", "@casys/mcp-erpnext"],
      "env": {
        "ERPNEXT_URL": "http://localhost:8000",
        "ERPNEXT_API_KEY": "your-api-key",
        "ERPNEXT_API_SECRET": "your-api-secret"
      }
    }
  }
}

与 ERPNext Cloud 合作 设置 ERPNEXT_URL 转到您 Frappe 云 URL (例如:. https://mycompany.erpnext.com 或者说 https://mysite.frappe.cloudAPI (英语) 密钥认证在自控和云层实例中同样有效.

VS 代码副驾驶

添加为 .vscode/mcp.json数字 :

{
  "servers": {
    "erpnext": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@casys/mcp-erpnext"],
      "env": {
        "ERPNEXT_URL": "http://localhost:8000",
        "ERPNEXT_API_KEY": "your-api-key",
        "ERPNEXT_API_SECRET": "your-api-secret"
      }
    }
  }
}

德诺( stidio)

{
  "mcpServers": {
    "erpnext": {
      "command": "deno",
      "args": ["run", "--allow-all", "server.ts"],
      "env": {
        "ERPNEXT_URL": "http://localhost:8000",
        "ERPNEXT_API_KEY": "your-api-key",
        "ERPNEXT_API_SECRET": "your-api-secret"
      }
    }
  }
}

HTTP 模式

对于一个共享的、总是运行的服务器,而不是每个客户端一个进程: 如何运行 HTTP 服务器注意它正在突破预-2026 HTTP客户端在 3.0.0.

类别过滤

只装入所需的类别 :

npx -y @casys/mcp-erpnext --categories=sales,inventory

类别和个人工具排除也得到支持,包括: 环境可变等同物:

deno run -A server.ts --categories=sales,inventory,operations --exclude-tools=erpnext_file_upload,erpnext_doc_delete

覆盖 CLI 值 ERPNEXT_CATEGORIES, (中文(简体) ), ERPNEXT_EXCLUDE_CATEGORIES,以及 ERPNEXT_EXCLUDE_TOOLS 个人。被排除在外的工具从电话中消失, 查看器动作和缓存热身。使用 --flag=value; 无效排除或一个空服务器选择失败启动。完整规则 : 工具选择。。。 .

新建实例设置

空白的 ERPNext 实例没有主数据, 因此商业工具失败验证直到它存在为止。见种子为空白的 ERPN ext 实例。。。 .

UI 查看器

九次互动 MCP 应用程序已登记为 ui://mcp-erpnext/{name}数字 :

查看器	说明	交互式特性
`doc-viewer`	带有字段和儿童表格的通用ERPN下一份文件	能力型附件,打入导航,有守卫的提交/取消,生JSON倒置.
`doclist-viewer`	带有排序、过滤器、页码、 CSV 导出的一般文档表格	内含细节,打入巢导航,提交/取消,以及紧凑状态过滤.
`invoice-viewer`	销售订单、销售发票和说明,共计	货品、股票、聚会和付款导航以及备案/撤销行动.
`stock-viewer`	配有颜色编码的qty徽章的股票平衡表	项目细节、最近动向、种群图和入库导航.
`chart-viewer`	通用图表渲染器( 通过 Recharts 有12 个类型)	精确点/序列导航和在简单和由人组成的图表中选择活文本.
`kanban-viewer`	读写 kanban 任务、机会、问题	拖放,内置编辑,序列化保存,并打入相干文档导航.
`kpi-viewer`	有三角洲、火花和趋势的大牌	数字和趋势导航,带有边框的活文本选择.
`funnel-viewer`	有换算率的Trapzoid销售漏斗	有期感相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相.
`buy-evidence-viewer`	采购证据(只记录会议)	完整、部分、未解决和无法预测;没有实时企业资源规划系统更新或突变.

查看和购买结果字段使用主机语言:英文、法文、简化华人,传统华人,印地语,孟加拉语,泰米尔语和乌尔都语. 中国脚本标记优先于区域标记; zh-TW, (中文(简体) ), zh-HK 财务报告和审定财务报表 zh-MO 选择没有指定脚本时的传统汉语. 乌尔都语使用从右到左文档方向, 以及后来的主机地块更改更新语言和方向不重新装入取景器。 App级等待和拒绝屏幕在3.2中保留英文标签; 主机文本支持这些共享表面屏幕仍然是MCP View的上游后续.

查看者逐步选择由主机支持的最佳交互 :

serverTools 在当前范围内打开已打入的列表、记录和图表目标浏览器通过 app.callServerTool()返回和面包屑导航恢复每个级别的状况.
downloadFile 让主机确认并保存返回的附件为绑定了嵌入式资源。服务器还要求 MCP 客户端宣布 mCP Apps 扩展名和 HTML MIME 类型在服务文件字节之前。这个查看器从不直接打开 ERPNext 文件 URL .
updateModelContext 让图表、 KPI 和漏斗选择加入边框活动文本快照。紧凑的上下文芯片最多可保存8项和让用户删除一个项目或清除全部项目。该快照包含选中的值,绝不为模型隐藏指令.
message.text 保留 app.sendMessage() 作为对话的后退无法直接导航或上下文替换.
没有这些能力,仍可在当地进行检查,而且得不到支持远程动作被省略.
"买"证据取景器只录制会话. 它不调用服务器工具,刷新活文件,或变异ERP状态.

服务器提供打入的导航元数据及精确 _availableTools 允许每个查看器使用, 因此分类过滤的部署不会显示工具未装入.

刷新模式

唯读取景器在焦点上通过刷新控制重新验证. 突变使用明确的只读请求来获取承诺状态; 突变工具永远不会自动重放。重叠或僵化的反应被忽略当新的宿主有效载荷或突变已经获胜时。一份确认的文件更改标记当前导航堆栈中每个可能衍生的快照作为 stale; 每个标记仅在表面实际读取时被去除再来一次分开的 MCP Apps在3.2中不自动同步.

构建 UI 查看器

cd src/ui
npm ci
node build-all.mjs

对于本地迭代, 运行 deno task ui:dev-host 从寄存器根。这个本地测试主机使用本地 MCP 服务器及其已建的查看器,重建并重新装入,而不重新启动桌面客户端。打开 http://127.0.0.1:5177/?viewer=doclist 真实的公司名单. 主机记录查看器上下文更新,但没有连接模式 ; 模型消耗和对话动作需要桌面主机检查 .

购买证据抓取

一个只读工具和一个记录App. 他们不购买, 创建 BOM/RFQ/PO, 刷新现场文件, 替换通用ERP浏览器, 或限定 (原始内容存档于2018-10-21). live ERPNext example.

工具 : erpnext_buy_capture仅关闭 DocTypes (项目,BOM,项目价格, 供应商报价、供应商、价格清单、UOM、货币兑换。两个 skipCache 读取必须同意 modified 和封闭的预测指纹。归来为麻黄克通JSON + SHA-256+字节数. 这个呼叫者无法通过 sourceInstance, URL, 证书, capturedAt,或一个消化系统数字线索在自己的 CAS 中存储这些字节; 此服务器没有保留第二个CAS.
应用 : io.casys.mcp-erpnext.buy-evidence, App 版本 3.1.0 (独立软件包版本,资源 ui://mcp-erpnext/buy-evidence-viewer (单位:千美元)text/html;profile=mcp-app),显示 ui://mcp-erpnext/buy-evidence-manifest (单位:千美元)application/json, (中文(简体) ), acceptedActions =: viewer.session.apply 只有这个完整、部分、, 尚未解决,且未提供的预测仍贴有标签。没有医生刷新、变异或 app.callServerTool届会 anchor 是密封的数字线程动画provenance.bundleRef),而不是显示的散列预测.
司马: io.casys.mcp-erpnext.buy-source-capture/1.0, (中文(简体) ), io.casys.mcp-erpnext.buy-recorded-result/1.0 财务报告和审定财务报表 /2.0, (中文(简体) ), io.casys.mcp-erpnext.buy-recorded-session/1.0。。。 .
结果 /2.0 带框 excludedLines 选定行的元数据未计价 lines:准确的行号,数量,单位,并说明理由. 它没有金额、货币或价格来源;覆盖的小计仍然保留封存值和未解决行仍然可见.
观看器是与其他 MCP Apps 一起建造的 (单位:千美元)cd src/ui && npm ci && node build-all.mjs) (中文(简体) ). 出版的JSR/npm文物包含 src/ui/dist/ 和购买类型脚本模块; HTML 资源已公布的装置能提供哪些服务.

数字线索拥有配置/封存( Q)buy-configuration/1.0, (中文(简体) ), buy-cost-bundle/1.0, (中文(简体) ), buy.capture-configuration-cost@1, (中文(简体) ), buy.seal-configuration-cost@1) (中文(简体) ). 合格 commerce.read-erpnext-buy-source@1 发送前必须具有约束力.

工具

记录 _list 工具通过行的 doclist-查看器返回交互式结果点击,内含细节,并交叉查看器导航. 具体附件 erpnext_file_list 工具不提供 doclist-查看器。通用和专用文档读取使用 doc-viewer,但销售订单、销售发票和引文,保留专用发票表面.

销售客户、销售订单、发票和带有完整CRUD的提示, 提交,并取消.
采购 - 供应商、采购订单、购货发票、收据和供应商说明.
库存物品、库存余额、仓库和库存物品.
会计会计科目表、期刊条目和付款条目.
人力资源 - 雇员、出勤、请假申请、薪片、薪金入帐和开销索赔.
项目项目、任务(有本地任务)和时间表.
交付 ——快递说明和货运.
制造业 ——工商局,劳动订单和工作卡.
客户关系管理 领导、机会、联系和运动.
资产资产、流动、维修记录和类别.
业务通用 CRUD,本地任务,附件列表,上传, 主机代理下载, 拒绝默认 Frappe 方法调用 (单位:千美元)erpnext_doc_*, (中文(简体) ), erpnext_file_*, (中文(简体) ), erpnext_method_call) (中文(简体) ).
关班任务、机会和发行的读写板拖来拖去.
分析图表(栏、面积、树图、雷达、散射、P&L.),KPI 火花和销售漏斗.
买 ——只读封装的封闭商业文件抓取 (单位:千美元)erpnext_buy_capture)和一个不可改变的记录片段证据查看器。没有 a 购买、BOM/RFQ/PO,或现场企业资源规划系统资格.
设置 ——公司创建和可转让用户上市.

参数的每个工具的完整参考: docs/tools.md。。。 .

环境变量

变量	需求	说明
`ERPNEXT_URL`	对	ERPN后一基础URL——自发托管(例如. `http://localhost:8000`)或云(如来相. `https://mycompany.erpnext.com`(中文(简体) )
`ERPNEXT_API_KEY`	对	来自用户设置的 API 密钥
`ERPNEXT_API_SECRET`	对	API 用户设置的秘密
`ERPNEXT_MAX_UPLOAD_BYTES`	没有	最大解码的文件上载大小, 以字节计( 正整数; 默认: 10 MiB)
`ERPNEXT_MAX_DOWNLOAD_BYTES`	没有	最大附件下载大小, 以字节计( 正整数; 默认: 10 MiB)
`ERPNEXT_METHOD_ALLOWLIST`	没有	逗号分隔的精确方法路径或 `prefix.`; 未设置表示 `erpnext_method_call` 否认每一种方法,而 `` 允许全部
`MCP_MRTR_SIGNING_KEY`	没有	完全64个小写十六进制字符; 允许签名的模糊链接引出 . 仅在单一情况下部署 - 见下文

MRTR是选入. 没有这把钥匙,或者当客户端不做广告时诱导、模糊的链接不断回溯现有的可诉模糊错误而不是提示选择 .

不要在此配置的负载平衡器后运行 MRTR . 这个签名密钥证明重试令牌是真实的;它不会使其成为单用. 这是重播店的工作,默认的是一个进程-本地。份额在两个实例和相同的签名重试中确定定购单、请假申请或费用报销两次, (中文(简体) ), 一经提交就不可逆转.

多事件部署必须经过一个共同原子 mrtr.replayStore 改为 McpApp (重新满足合同与 SET key 1 NX EXAT) (中文(简体) ). 这个框架在启动时记录一个警告, 当MRTR启用时没有一个警告 - 警告不是噪音,而是这一段.

建筑

工具按业务领域分类 src/tools/, Frappe REST 客户端无依赖性,每个UI查看器都是在 src/ui/完整版式 : 仓库布局。。。 .

npm 软件包

Npm 软件包 (@casys/mcp-erpnext)是单自装订的捆绑与零运行时间依赖。 UI观众被嵌入. 需要节点20.

捐款

欢迎捐款——见 捐款额 获取开始,和一般事务人员(其他职等) 整个架构和公约.

许可证

麻省理工学院

版本与发布记录

@casys/mcp-erpnext 共发布 49 个版本，首次发布于 2026/02/24；过去 12 个月发布了 49 个版本。

版本	发布日期	距今
`3.5.0`latest	2026/11/05	3 天前
`3.4.0`	2026/11/05	3 天前
`3.3.2`	2026/11/05	3 天前
`3.3.1`	2026/11/01	7 天前
`3.3.0`	2026/10/18	22 天前
`3.2.3`	2026/10/18	22 天前

关于 @casys/mcp-erpnext 的常见问题

@casys/mcp-erpnext 是什么？

带有交互式 UI 查看器的 MCP ERPNext 服务器

如何安装 @casys/mcp-erpnext？

在项目目录运行 npm install @casys/mcp-erpnext，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp-erpnext，可以用 npx mcp-erpnext 直接运行。

@casys/mcp-erpnext 支持 TypeScript 吗？

该包的 package.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/casys__mcp-erpnext 是否存在。

@casys/mcp-erpnext 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。

@casys/mcp-erpnext 需要什么版本的 Node.js？

package.json 的 engines 字段要求 Node.js >=20.0.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@casys/mcp-erpnext 可以商用吗？

@casys/mcp-erpnext 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

@casys/mcp-erpnext 的下载量有多少？

根据 npm 官方下载统计，@casys/mcp-erpnext 在 2026/10/09 – 2026/11/07 这 30 天内被下载 4,930 次，日均约 164 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@casys/mcp-erpnext 还在维护吗？

最新版本 3.5.0 发布于 2026/11/05（3 天前）；至今共发布 49 个版本，其中过去 12 个月发布了 49 个；首次发布于 2026/02/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

npm install @casys/mcp-erpnext

pnpmpnpm add @casys/mcp-erpnext
yarnyarn add @casys/mcp-erpnext
bunbun add @casys/mcp-erpnext

命令行npx mcp-erpnext

在你的项目目录中运行此命令。

近 30 天下载

4,930

约 4930 次日均 164 次

统计周期 2026/10/09 – 2026/11/07
数据来自 npm 官方下载统计，今天更新

最新版本3.5.0发布于 3 天前

开源许可MIT宽松许可

包体积12.5 MB14 个文件 · 解压后

运行依赖0 个零依赖

模块格式ES Module

TypeScript未声明类型可查找 @types/casys__mcp-erpnext

Node.js>=20.0.0

发布版本49 个近 12 个月 49 个

首次发布2026/02/248 个月前

元数据更新2026/11/05

每一个软件包背后，
都有分享与创造的人。