Skip to main content
Glama
deenesjakoruzh
tourscale-repos

Frappe MCP

by tourscale-repos
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Frappe MCP

Schreibgeschützter Model Context Protocol-Server für die TourScale ERPNext / FranOS-Instanz unter erp.tourscale.com. Ermöglicht Agenten das Abfragen von Franchisenehmern, Franchiseverträgen, FBUs, Vermögenswerten, COIs sowie ERPNext-Rechnungen und Hauptbucheinträgen.

Was er bereitstellt

Tool

Zweck

whoami

Konnektivitätsprüfung — gibt die Identität des API-Benutzers zurück

list_franchisees(status, brand, limit)

Franchisenehmer mit optionalen Filtern

get_franchisee(name)

Vollständiges Franchisenehmer-Dokument nach Name (z. B. FZE-00001)

list_fas(franchisee, status, expiring_within_days, limit)

Franchiseverträge; Ablaufzeitraum-Schlüssel für Compliance Watchdog

get_fa(name)

Ein FA mit untergeordneten Tabellen (Marken/Lizenzgebühren/Gebiet)

list_fbus(franchisee, brand, limit)

FBUs

get_fbu(name)

Ein FBU mit Betriebsadressen

list_assets(franchisee, asset_type, limit)

Fahrzeuge/Schiffe

list_cois(franchisee, expiring_within_days, limit)

Versicherungszertifikate (COI) mit Filter für Erneuerungszeitraum

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

Generischer Ausweg für jeden Doctype

frappe_get_doc(doctype, name)

Generisches Abrufen nach Name

frappe_count(doctype, filters_json)

Datensätze zählen

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

Verkaufsrechnungen

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

Hauptbucheinträge

Related MCP server: easypaydirect-mcp

Funktionsweise der Authentifizierung

Kommuniziert mit der ERPNext REST-API als Benutzer claude-mcp@tourscale.com über API-Key + Secret (Frappe-natives Authentifizierungsschema: Authorization: token <key>:<secret>).

Der Benutzer besitzt die Rolle System Manager in ERPNext. Die MCP-Ebene ist die Vertrauensgrenze — die oben genannten Tools sind konzeptbedingt schreibgeschützt. Fügen Sie nicht leichtfertig Schreib-Tools hinzu; Agenten, die Daten ändern müssen, sollten spezifische, zweckgebundene Tools aufrufen, keine generischen CRUD-Operationen.

Zum Rotieren der Schlüssel: Führen Sie den generate_keys-Ablauf in bench --site erp.tourscale.local console erneut aus, aktualisieren Sie FRAPPE_API_KEY + FRAPPE_API_SECRET in der Master-Umgebung und starten Sie ts-frappe-mcp neu.

Bereitstellung

  • Container: ts-frappe-mcp auf tourscale-net

  • Port: gebunden an 127.0.0.1:8096 (nur Loopback — erreichbar über lokalen Agenten-Client oder SSH-Tunnel)

  • Compose-Eintrag befindet sich in /opt/tourscale/docker-compose.services.yml

  • Env-Datei: /opt/tourscale/frappe-mcp/.env (bezogen aus der Master-Umgebung)

Lokale Entwicklung

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

Rufen Sie dann die Tools über einen beliebigen MCP-Client auf (Claude Code, FastMCP-Debug-Tools usw.).

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