Erpnext

🚀 ERPNext MCP 服務器

這是一個基於 TypeScript 的 MCP 服務器，主要用於與 ERPNext/Frappe 接口集成。藉助該服務器，AI 助手能夠通過模型上下文協議（Model Context Protocol）與 ERPNext 的數據和功能進行交互。

🚀 快速開始

本服務器可助力 AI 助手通過模型上下文協議與 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：獲取所有可用文檔類型列表。

📦 安裝指南

開發環境安裝

安裝依賴：

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

與 Claude 在 VSCode 中一起使用

將服務器配置添加到：

• 在 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 檢查器，它作為包腳本可用：

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>

高級用法

創建新文檔

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

更新文檔

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

運行報表

<use_mcp_tool>
<server_name>erpnext</server_name>
<tool_name>run_report</tool_name>
<arguments>
{
  "report": "Sales Summary"
}
</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>

🔧 技術細節

服務器需要以下環境變量：

• ERPNEXT_URL：ERPNext 實例的基礎 URL。
• ERPNEXT_API_KEY (可選)：API 密鑰。
• ERPNEXT_API_SECRET (可選)：API 秘密。