@casys/mcp-erpnext 3.0.1 → 3.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +27 -28
  2. package/mcp-erpnext.mjs +26353 -18410
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -6,14 +6,12 @@ English | [繁體中文](README.zh-TW.md)
6
6
  [![npm](https://img.shields.io/npm/v/@casys/mcp-erpnext?logo=npm&color=cb3837)](https://www.npmjs.com/package/@casys/mcp-erpnext)
7
7
  [![CI](https://github.com/Casys-AI/mcp-erpnext/actions/workflows/test.yml/badge.svg)](https://github.com/Casys-AI/mcp-erpnext/actions/workflows/test.yml)
8
8
  [![MCP](https://img.shields.io/badge/MCP-server-1f6feb?logo=modelcontextprotocol&logoColor=white)](https://modelcontextprotocol.io)
9
+ [![M8ven Score](https://m8ven.ai/badge/mcp/casys-ai-mcp-erpnext-1kev4k)](https://m8ven.ai/mcp/casys-ai-mcp-erpnext-1kev4k)
9
10
  [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
10
11
 
11
- MCP server for [ERPNext](https://erpnext.com) / Frappe ERP — **124 tools**
12
- across **14 categories**, with **7 interactive UI viewers**.
13
-
14
- Connect any MCP-compatible AI agent (Claude Desktop, Claude Code, VS Code
15
- Copilot, custom) to your ERPNext instance via the
16
- [Model Context Protocol](https://modelcontextprotocol.io).
12
+ Let any MCP-compatible AI agent operate your [ERPNext](https://erpnext.com) /
13
+ Frappe instance — documents, workflows, and interactive viewers inside the host
14
+ (Claude Desktop, Claude Code, VS Code Copilot, or custom).
17
15
 
18
16
  Works with **self-hosted** and **ERPNext Cloud** (frappe.cloud) instances.
19
17
 
@@ -222,32 +220,32 @@ npm install
222
220
  node build-all.mjs
223
221
  ```
224
222
 
225
- ## Tools (124)
223
+ ## Tools
226
224
 
227
- 124 tools across 14 categories. Each `_list` tool returns interactive results
228
- via the doclist-viewer with row click, inline detail, and cross-viewer
229
- navigation.
225
+ Each `_list` tool returns interactive results via the doclist-viewer with row
226
+ click, inline detail, and cross-viewer navigation.
230
227
 
231
- - **Sales** (17) — Customers, Sales Orders, Invoices, and Quotations with full
232
- CRUD, Submit, and Cancel.
233
- - **Purchasing** (11) — Suppliers, Purchase Orders, Purchase Invoices, Receipts,
234
- and Supplier Quotations.
235
- - **Inventory** (9) — Items, Stock Balance, Warehouses, and Stock Entries.
236
- - **Accounting** (6) — Chart of Accounts, Journal Entries, and Payment Entries.
237
- - **HR** (12) — Employees, Attendance, Leave Applications, Salary Slips, Payroll
228
+ - **Sales** — Customers, Sales Orders, Invoices, and Quotations with full CRUD,
229
+ Submit, and Cancel.
230
+ - **Purchasing** — Suppliers, Purchase Orders, Purchase Invoices, Receipts, and
231
+ Supplier Quotations.
232
+ - **Inventory** — Items, Stock Balance, Warehouses, and Stock Entries.
233
+ - **Accounting** — Chart of Accounts, Journal Entries, and Payment Entries.
234
+ - **HR** — Employees, Attendance, Leave Applications, Salary Slips, Payroll
238
235
  Entries, and Expense Claims.
239
- - **Project** (9) — Projects, Tasks (with native assignment), and Timesheets.
240
- - **Delivery** (5) — Delivery Notes and Shipments.
241
- - **Manufacturing** (7) — BOMs, Work Orders, and Job Cards.
242
- - **CRM** (8) — Leads, Opportunities, Contacts, and Campaigns.
243
- - **Assets** (8) — Assets, Movements, Maintenance records, and Categories.
244
- - **Operations** (10) — Generic CRUD, native assignment, and file upload for any
245
- DocType (`erpnext_doc_*`, `erpnext_file_upload`).
246
- - **Kanban** (2) — Read-write boards for Task, Opportunity, and Issue with
236
+ - **Project** — Projects, Tasks (with native assignment), and Timesheets.
237
+ - **Delivery** — Delivery Notes and Shipments.
238
+ - **Manufacturing** — BOMs, Work Orders, and Job Cards.
239
+ - **CRM** — Leads, Opportunities, Contacts, and Campaigns.
240
+ - **Assets** — Assets, Movements, Maintenance records, and Categories.
241
+ - **Operations** — Generic CRUD, native assignment, file upload, and
242
+ deny-by-default Frappe method calls (`erpnext_doc_*`, `erpnext_file_upload`,
243
+ `erpnext_method_call`).
244
+ - **Kanban** — Read-write boards for Task, Opportunity, and Issue with
247
245
  drag-and-drop.
248
- - **Analytics** (17) — 11 analytics charts (bar, area, treemap, radar, scatter,
249
- P&L…), 5 KPIs with sparklines, and a sales funnel.
250
- - **Setup** (3) — Company creation and assignable user listing.
246
+ - **Analytics** — Charts (bar, area, treemap, radar, scatter, P&L…), KPIs with
247
+ sparklines, and a sales funnel.
248
+ - **Setup** — Company creation and assignable user listing.
251
249
 
252
250
  Full per-tool reference with parameters: [`docs/tools.md`](docs/tools.md).
253
251
 
@@ -259,6 +257,7 @@ Full per-tool reference with parameters: [`docs/tools.md`](docs/tools.md).
259
257
  | `ERPNEXT_API_KEY` | Yes | API Key from User Settings |
260
258
  | `ERPNEXT_API_SECRET` | Yes | API Secret from User Settings |
261
259
  | `ERPNEXT_MAX_UPLOAD_BYTES` | No | Maximum decoded file-upload size in bytes (positive integer; default: 10 MiB) |
260
+ | `ERPNEXT_METHOD_ALLOWLIST` | No | Comma-separated exact method paths or `prefix.*`; unset means `erpnext_method_call` denies every method, while `*` allows all |
262
261
  | `MCP_MRTR_SIGNING_KEY` | No | Exactly 64 lowercase hex characters; enables signed ambiguous-link elicitation. **Single-instance deployments only** — see below |
263
262
 
264
263
  MRTR is opt-in. Without this key, or when the client does not advertise