Skip to main content
Glama
tourscale-repos

Frappe MCP

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

F
license - not found
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    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.
    282
    AGPL 3.0
  • 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
    37
    MIT
  • A
    license
    -
    quality
    B
    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
  • A
    license
    -
    quality
    C
    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.
    1
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/tourscale-repos/frappe-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server