Skip to main content
Glama
deenesjakoruzh
tourscale-repos

Frappe MCP

by tourscale-repos
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Frappe MCP

Servidor de Model Context Protocol de solo lectura para la instancia de TourScale ERPNext / FranOS en erp.tourscale.com. Permite a los agentes consultar franquiciados, acuerdos de franquicia, FBU, activos, COI y facturas/asientos contables de ERPNext.

Qué expone

Herramienta

Propósito

whoami

Prueba de conectividad: devuelve la identidad del usuario de la API

list_franchisees(status, brand, limit)

Franquiciados con filtros opcionales

get_franchisee(name)

Documento completo del franquiciado por nombre (p. ej., FZE-00001)

list_fas(franchisee, status, expiring_within_days, limit)

Acuerdos de franquicia; ventana de vencimiento clave para el Compliance Watchdog

get_fa(name)

Un FA con tablas secundarias (marcas/regalías/territorio)

list_fbus(franchisee, brand, limit)

FBU

get_fbu(name)

Un FBU con direcciones operativas

list_assets(franchisee, asset_type, limit)

Vehículos/embarcaciones

list_cois(franchisee, expiring_within_days, limit)

Certificado de seguro, con filtro de ventana de renovación

frappe_list_docs(doctype, filters_json, fields_json, limit, order_by)

Vía de escape genérica para cualquier doctype

frappe_get_doc(doctype, name)

Obtención genérica por nombre

frappe_count(doctype, filters_json)

Contar registros

erpnext_list_invoices(franchisee, status, date_from, date_to, limit)

Facturas de venta

erpnext_gl_entries(account, party, date_from, date_to, limit)

Asientos del libro mayor

Related MCP server: easypaydirect-mcp

Cómo funciona la autenticación

Se comunica con la API REST de ERPNext como el usuario claude-mcp@tourscale.com mediante clave de API + secreto (esquema de autenticación nativo de Frappe: Authorization: token <key>:<secret>).

El usuario tiene el rol System Manager en ERPNext. La capa MCP es el límite de confianza: las herramientas anteriores son de solo lectura por diseño. No añada herramientas de escritura a la ligera; los agentes que necesiten realizar cambios deben llamar a herramientas específicas y limitadas, no a CRUD genéricos.

Para rotar las claves: vuelva a ejecutar el flujo generate_keys en bench --site erp.tourscale.local console, actualice FRAPPE_API_KEY + FRAPPE_API_SECRET en el entorno maestro y reinicie ts-frappe-mcp.

Despliegue

  • Contenedor: ts-frappe-mcp en tourscale-net

  • Puerto: vinculado a 127.0.0.1:8096 (solo loopback; acceda a través de un cliente agente local o túnel SSH)

  • La entrada de Compose reside en /opt/tourscale/docker-compose.services.yml

  • Archivo de entorno: /opt/tourscale/frappe-mcp/.env (obtenido del entorno maestro)

Desarrollo local

FRAPPE_API_URL=https://erp.tourscale.com \
FRAPPE_API_KEY=... \
FRAPPE_API_SECRET=... \
python3 server.py

Luego, llame a las herramientas a través de cualquier cliente MCP (Claude Code, herramientas de depuración FastMCP, etc.).

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors

Related MCP Servers

  • Frappe Assistant Core

    buildswithpaul
    A
    license
    Not graded
    quality
    A
    maintenance
    MCP server that enables LLMs to interact with ERPNext/Frappe sites for document CRUD, search, reports, workflows, and analytics, respecting user permissions and logging all actions.
    316
    AGPL 3.0

  • easypaydirect-mcp

    praveendias1180
    A
    license
    A
    quality
    A
    maintenance
    Read-only MCP server for Easy Pay Direct / NMI payment gateway, enabling natural language queries of transactions, subscriptions, and customer vault records.
    7
    241 npm
    MIT

  • Frappe Assistant Core

    OsamaASidd
    A
    license
    Not graded
    quality
    C
    maintenance
    MCP server that enables Claude, ChatGPT, and other LLMs to interact with ERPNext sites through natural language, supporting document CRUD, search, reports, workflows, and custom tools, while respecting user permissions and logging all calls.
    AGPL 3.0

  • Omie MCP

    mcp-dir
    A
    license
    Not graded
    quality
    D
    maintenance
    Read-only MCP server for Omie ERP, enabling AI assistants to query financial data, accounts payable/receivable, bank reconciliation, invoices, and movements via natural language.
    12
    MIT