ERPNext

🚀 ERPNext MCP 服务器

ERPNext MCP 服务器是一个用于 ERPNext 整合的模型上下文协议（Model Context Protocol）服务器。它基于 TypeScript 构建，提供与 ERPNext/Frappe API 集成的功能，能让 AI 助手通过 Model Context Protocol 访问 ERPNext 的数据和功能。

✨ 主要特性

资源

• 可通过 erpnext://{doctype}/{name} URI 访问 ERPNext 文档。
• 支持使用 JSON 格式进行结构化数据访问。

工具

• authenticate_erpnext：使用用户名和密码认证 ERPNext。
• get_documents：获取特定文档类型的文档列表。
• create_document：在 ERPNext 创建新文档。
• update_document：更新现有文档。
• run_report：运行 ERPNext 报表。
• get_doctype_fields：获取特定文档类型字段列表。
• get_doctypes：获取所有可用文档类型的列表。

📦 安装指南

服务器配置

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

• ERPNEXT_URL：您的 ERPNext 实例基础 URL。
• ERPNEXT_API_KEY（可选）：API 访问密钥。
• ERPNEXT_API_SECRET（可选）：API 密码。

开发环境安装

安装依赖项：

npm install

构建服务器：

npm run build

带自动重建的开发：

npm run watch

与 Claude 集成安装

与 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 服务器通过标准输入输出进行通信，调试可能具有挑战性。我们推荐使用 MCP Inspector，该工具可以通过包脚本运行：

npm run inspector

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

💻 使用示例

基础用法

身份验证

<use_mcp_tool>
<server_name>erpnextserver_name>
<tool_name>authenticate_erpnexttool_name>
<arguments>
{
"username": "your-username",
"password": "your-password"
}
arguments>
use_mcp_tool>

获取客户列表

<use_mcp_tool>
<server_name>erpnextserver_name>
<tool_name>get_documentstool_name>
<arguments>
{
"doctype": "Customer"
}
arguments>
use_mcp_tool>

创建文档

<use_mcp_tool>
<server_name>erpnextserver_name>
<tool_name>create_documenttool_name>
<arguments>
{
"doctype": "Sales Invoice",
"data": {
"customer": "Test Customer",
"amount": 100
}
}
arguments>
use_mcp_tool>

更新文档

<use_mcp_tool>
<server_name>erpnextserver_name>
<tool_name:update_document>
{
"doctype": "Sales Invoice",
"name": "INV-001",
"data": {
"amount": 200
}
}
arguments>
use_mcp_tool>

运行报表

<use_mcp_tool>
<server_name>erpnextserver_name>
<tool_name>run_reporttool_name>
<arguments>
{
"report": "Sales Report",
"filters": {
"from_date": "2023-01-01",
"to_date": "2023-12-31"
}
}
arguments>
use_mcp_tool>

获取文档类型字段

<use_mcp_tool>
<server_name>erpnextserver_name>
<tool_name>get_doctype_fieldstool_name>
<arguments>
{
"doctype": "Sales Invoice"
}
arguments>
use_mcp_tool>

获取所有文档类型

<use_mcp_tool>
<server_name>erpnextserver_name>
<tool_name>get_doctypestool_name>
use_mcp_tool>