MCP-сервер для ERPNext

Сервер протокола 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: ERPNext 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>