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>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>

創建文檔

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

更新文檔

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

運行報表

<use_mcp_tool>
<server_name>erpnext</server_name>
<tool_name>run_report</tool_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>erpnext</server_name>
<tool_name>get_doctype_fields</tool_name>
<arguments>
{
  "doctype": "Sales Invoice"
}
</arguments>
</use_mcp_tool>

獲取所有文檔類型

<use_mcp_tool>
<server_name>erpnext</server_name>
<tool_name>get_doctypes</tool_name>
</use_mcp_tool>