ERPNext MCP Server

ERPNext MCP Server

site icon
2025.04.01 3
JavaScript企业资源规划ERP集成自动化金融服务交流协作
ERPNext MCP Server 是一个基于 TypeScript 的 MCP 服务器,用于与 ERPNext/Frappe API 集成。它允许 AI 助手通过 Model Context Protocol 与 ERPNext 数据和功能进行交互。该服务器提供了多种工具和功能,包括文档访问、创建、更新、报告运行等,适用于企业资源规划(ERP)系统的集成和自动化。
View on GitHub

Overview

基本能力

产品定位

ERPNext MCP Server 是一个用于与 ERPNext 系统集成的 MCP 服务器,旨在通过 AI 助手实现与 ERPNext 数据和功能的交互。

核心功能

  • 资源访问:通过 erpnext://{doctype}/{name} URI 访问 ERPNext 文档。
  • 工具集
  • authenticate_erpnext:使用用户名和密码与 ERPNext 进行认证。
  • get_documents:获取特定文档类型的文档列表。
  • create_document:在 ERPNext 中创建新文档。
  • update_document:更新 ERPNext 中的现有文档。
  • run_report:运行 ERPNext 报告。
  • get_doctype_fields:获取特定文档类型的字段列表。
  • get_doctypes:获取所有可用文档类型的列表。

适用场景

  • 企业资源规划(ERP)系统的集成和自动化。
  • 通过 AI 助手实现与 ERPNext 数据的交互。
  • 自动化文档创建、更新和报告生成。

使用教程

使用依赖

安装依赖:

npm install

安装教程

  1. 构建服务器:
npm run build
  1. 开发时自动重建:
npm run watch
  1. 配置服务器:
  2. 在 MacOS 上:~/Library/Application Support/Claude/claude_desktop_config.json
  3. 在 Windows 上:%APPDATA%/Claude/claude_desktop_config.json
  4. 添加以下配置:
{
  "mcpServers": {
    "erpnext": {
      "command": "node",
      "args": ["/path/to/erpnext-server/build/index.js"],
      "env": {
        "ERPNEXT_URL": "http://your-erpnext-instance.com",
        "ERPNEXT_API_KEY": "your-api-key",
        "ERPNEXT_API_SECRET": "your-api-secret"
      }
    }
  }
}

调试方式

使用 MCP Inspector 进行调试:

npm run inspector

常见问题解答

  • 如何认证 ERPNext? 使用 authenticate_erpnext 工具,提供用户名和密码。
  • 如何获取文档列表? 使用 get_documents 工具,指定文档类型。
  • 如何创建新文档? 使用 create_document 工具,提供文档类型和数据。
  • 如何调试服务器? 使用 npm run inspector 启动 MCP Inspector,通过浏览器访问调试工具。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。