ERPNext MCP 服务器

用于 ERPNext 集成的模型上下文协议服务器

这是一个基于 TypeScript 的 MCP 服务器，提供与 ERPNext/Frappe API 的集成。它使 AI 助手能够通过模型上下文协议 (MCP) 与 ERPNext 数据和功能进行交互。

特征

资源

通过erpnext://{doctype}/{name} URI 访问 ERPNext 文档
用于结构化数据访问的 JSON 格式

工具

authenticate_erpnext - 使用用户名和密码向 ERPNext 进行身份验证
get_documents - 获取特定文档类型的文档列表
create_document - 在 ERPNext 中创建新文档
update_document - 更新 ERPNext 中的现有文档
run_report - 运行 ERPNext 报告
get_doctype_fields - 获取特定 DocType 的字段列表
get_doctypes - 获取所有可用 DocType 的列表

配置

服务器需要以下环境变量：

ERPNEXT_URL - ERPNext 实例的基本 URL
ERPNEXT_API_KEY （可选）- 用于身份验证的 API 密钥
ERPNEXT_API_SECRET （可选）- 用于身份验证的 API 密钥

发展

安装依赖项：

npm install

构建服务器：

npm run build

对于使用自动重建的开发：

npm run watch

安装

要与 Claude Desktop 一起使用，请添加服务器配置：

在 MacOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json在 Windows 上： %APPDATA%/Claude/claude_desktop_config.json

{
  "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"
      }
    }
  }
}

要在 VSCode 中与 Claude 一起使用，请将服务器配置添加到：

在 MacOS 上： ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json在 Windows 上： %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

调试

由于 MCP 服务器通过 stdio 进行通信，调试起来可能比较困难。我们推荐使用MCP Inspector ，它以包脚本的形式提供：

npm run inspector

检查器将提供一个 URL 来访问浏览器中的调试工具。

使用示例

验证

<use_mcp_tool>
<server_name>erpnext</server_name>
<tool_name>authenticate_erpnext</tool_name>
<arguments>
{
  "username": "your-username",
  "password": "your-password"
}
</arguments>
</use_mcp_tool>

获取客户列表

<use_mcp_tool>
<server_name>erpnext</server_name>
<tool_name>get_documents</tool_name>
<arguments>
{
  "doctype": "Customer"
}
</arguments>
</use_mcp_tool>

获取客户详细信息

<access_mcp_resource>
<server_name>erpnext</server_name>
<uri>erpnext://Customer/CUSTOMER001</uri>
</access_mcp_resource>

创建新项目

<use_mcp_tool>
<server_name>erpnext</server_name>
<tool_name>create_document</tool_name>
<arguments>
{
  "doctype": "Item",
  "data": {
    "item_code": "ITEM001",
    "item_name": "Test Item",
    "item_group": "Products",
    "stock_uom": "Nos"
  }
}
</arguments>
</use_mcp_tool>

获取项目字段

<use_mcp_tool>
<server_name>erpnext</server_name>
<tool_name>get_doctype_fields</tool_name>
<arguments>
{
  "doctype": "Item"
}
</arguments>
</use_mcp_tool>

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

基于 TypeScript 的服务器，使 AI 助手能够通过模型上下文协议与 ERPNext/Frappe 系统交互，从而允许访问文档、创建/更新记录以及运行报告。

Related MCP Servers

Prefect MCP Server
allen-munsch
-
security
F
license
-
quality
A Model Context Protocol server that allows AI assistants to interact with Prefect's workflow automation platform through natural language, enabling users to manage flows, deployments, tasks, and other Prefect resources via conversational commands.
Last updated -
15
erpnext-server
rakeshgangwar
-
security
A
license
-
quality
This is a TypeScript-based MCP server that provides integration with ERPNext/Frappe API. It enables AI assistants to interact with ERPNext data and functionality through the Model Context Protocol.
Last updated -
31
MIT License
ERPNext MCP Server
sivabhogela88
-
security
A
license
-
quality
A production-ready server that integrates ERPNext with AI assistants like Claude Desktop, enabling document operations, reporting, and analytics through natural language.
Last updated -
MIT License
ERPNext MCP Server
sivabhogela88
-
security
A
license
-
quality
A production-ready server that enables AI assistants like Claude Desktop to seamlessly integrate with ERPNext for document operations, reporting, and custom workflows through natural language interaction.
Last updated -
MIT License

View all related MCP servers

ERPNext MCP Server