Servidor ERPNext MCP

Un servidor de protocolo de contexto de modelo para la integración de ERPNext

Este es un servidor MCP basado en TypeScript que se integra con la API de ERPNext/Frappe. Permite que los asistentes de IA interactúen con los datos y la funcionalidad de ERPNext mediante el Protocolo de Contexto de Modelo.

Características

Recursos

Acceda a los documentos de ERPNext a través de los URI erpnext://{doctype}/{name}
Formato JSON para acceso a datos estructurados

Herramientas

authenticate_erpnext - Autenticarse con ERPNext usando nombre de usuario y contraseña
get_documents - Obtener una lista de documentos para un tipo de documento específico
create_document - Crea un nuevo documento en ERPNext
update_document - Actualizar un documento existente en ERPNext
run_report - Ejecutar un informe ERPNext
get_doctype_fields - Obtener la lista de campos para un DocType específico
get_doctypes - Obtener una lista de todos los DocTypes disponibles

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 API para autenticación
ERPNEXT_API_SECRET (opcional): secreto de API para autenticación

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Instalación

Para utilizar con Claude Desktop, agregue 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, agregue la configuración del servidor a:

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 complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:

npm run inspector

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

Ejemplos de uso

Autenticación

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

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 elementos

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

ERPNext MCP Server