ERPNext MCP Server

Сервер Model Context Protocol для интеграции с ERPNext

Это сервер MCP на базе TypeScript, обеспечивающий интеграцию с API ERPNext/Frappe. Он позволяет ИИ-ассистентам взаимодействовать с данными и функциональностью ERPNext через протокол Model Context Protocol.

Возможности

Ресурсы

• Доступ к документам ERPNext через URI erpnext://{doctype}/{name}

• Формат JSON для доступа к структурированным данным

Инструменты

• get_doctypes — Получить список всех доступных DocType

• get_doctype_fields — Получить список полей для конкретного DocType

• get_documents — Получить список документов для конкретного doctype

• get_document — Получить один документ по имени, включая все дочерние таблицы

• create_document — Создать новый документ в ERPNext

• update_document — Обновить существующий документ в ERPNext

• delete_document — Безвозвратно удалить документ

• submit_document — Отправить документ (установить docstatus в 1)

• cancel_document — Отменить отправленный документ (установить docstatus в 2)

• call_method — Вызвать разрешенный (whitelisted) серверный метод API ERPNext/Frappe

• run_report — Запустить отчет ERPNext

Related MCP server: Prefect MCP Server

Конфигурация

Сервер требует следующие переменные окружения:

• ERPNEXT_URL — Базовый URL вашего экземпляра ERPNext

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

Для использования с 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 обмениваются данными через stdio, отладка может быть затруднительна. Мы рекомендуем использовать MCP Inspector, который доступен в виде пакетного скрипта:

npm run inspector

Инспектор предоставит URL для доступа к инструментам отладки в вашем браузере.

Примеры использования

Получить список клиентов

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