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>

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Un servidor basado en TypeScript que permite a los asistentes de IA interactuar con los sistemas ERPNext/Frappe a través del Protocolo de Contexto de Modelo, lo que permite el acceso a documentos, la creación/actualización de registros y la ejecución de informes.

Related MCP Servers

Prefect MCP Server
allen-munsch
-
security
F
license
-
quality
A Model Context Protocol server that allows AI assistants to interact with Prefect's workflow automation platform through natural language, enabling users to manage flows, deployments, tasks, and other Prefect resources via conversational commands.
Last updated -
12
Python
erpnext-server
rakeshgangwar
-
security
A
license
-
quality
This is a TypeScript-based MCP server that provides integration with ERPNext/Frappe API. It enables AI assistants to interact with ERPNext data and functionality through the Model Context Protocol.
Last updated -
21
JavaScript
MIT License
ERPNext MCP Server
sivabhogela88
-
security
A
license
-
quality
A production-ready server that integrates ERPNext with AI assistants like Claude Desktop, enabling document operations, reporting, and analytics through natural language.
Last updated -
TypeScript
MIT License
ERPNext MCP Server
sivabhogela88
-
security
A
license
-
quality
A production-ready server that enables AI assistants like Claude Desktop to seamlessly integrate with ERPNext for document operations, reporting, and custom workflows through natural language interaction.
Last updated -
TypeScript
MIT License

View all related MCP servers

ERPNext MCP Server