Servidor MCP de ERPNext

Un servidor del Protocolo de Contexto de Modelo (MCP) para la integración con ERPNext

Este es un servidor MCP basado en TypeScript que proporciona integración con la API de ERPNext/Frappe. Permite a los asistentes de IA interactuar con los datos y la funcionalidad de ERPNext a través del Protocolo de Contexto de Modelo.

Características

Recursos

• Acceso a documentos de ERPNext mediante URIs erpnext://{doctype}/{name}

• Formato JSON para el acceso a datos estructurados

Herramientas

• get_doctypes - Obtener una lista de todos los DocTypes disponibles

• get_doctype_fields - Obtener la lista de campos para un DocType específico

• get_documents - Obtener una lista de documentos para un doctype específico

• get_document - Obtener un único documento por nombre, incluyendo todas las tablas hijas

• create_document - Crear un nuevo documento en ERPNext

• update_document - Actualizar un documento existente en ERPNext

• delete_document - Eliminar permanentemente un documento

• submit_document - Enviar (submit) un documento (establece docstatus a 1)

• cancel_document - Cancelar un documento enviado (establece docstatus a 2)

• call_method - Llamar a un método de API del lado del servidor de ERPNext/Frappe incluido en la lista blanca

• run_report - Ejecutar un informe de ERPNext

Related MCP server: ERPNext MCP Server

Configuración

El servidor requiere las siguientes variables de entorno:

• ERPNEXT_URL - La URL base de su instancia de ERPNext

• ERPNEXT_API_KEY (opcional) - Clave de API para la autenticación

• ERPNEXT_API_SECRET (opcional) - Secreto de API para la autenticación

Desarrollo

Instalar dependencias:

npm install

Compilar el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Instalación

Para usar con Claude Desktop, añada la configuración del servidor:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json En 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"
      }
    }
  }
}

Para usar con Claude en VSCode, añada la configuración del servidor en:

En MacOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json En Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser un desafío. Recomendamos usar el Inspector MCP, que está disponible como un script del paquete:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

Ejemplos de uso

Obtener lista de clientes

<use_mcp_tool>
<server_name>erpnext</server_name>
<tool_name>get_documents</tool_name>
<arguments>
{
  "doctype": "Customer"
}
</arguments>
</use_mcp_tool>

Obtener detalles del cliente

<access_mcp_resource>
<server_name>erpnext</server_name>
<uri>erpnext://Customer/CUSTOMER001</uri>
</access_mcp_resource>

Crear nuevo artículo

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

Obtener campos de artículo

<use_mcp_tool>
<server_name>erpnext</server_name>
<tool_name>get_doctype_fields</tool_name>
<arguments>
{
  "doctype": "Item"
}
</arguments>
</use_mcp_tool>