Skip to main content
Glama
deenesjakoruzh
tourscale-repos

Frappe MCP

by tourscale-repos
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Frappe MCP

MCP-сервер (Model Context Protocol) с правами только на чтение для экземпляра TourScale ERPNext / FranOS по адресу erp.tourscale.com. Позволяет агентам запрашивать данные о франчайзи, франчайзинговых соглашениях, FBU, активах, сертификатах страхования (COI) и счетах/записях главной книги ERPNext.

Что он предоставляет

Инструмент

Назначение

whoami

Проверка подключения — возвращает идентификатор пользователя API

list_franchisees(status, brand, limit)

Франчайзи с опциональными фильтрами

get_franchisee(name)

Полный документ франчайзи по имени (например, FZE-00001)

list_fas(franchisee, status, expiring_within_days, limit)

Франчайзинговые соглашения; окно истечения срока для Compliance Watchdog

get_fa(name)

Одно соглашение FA с дочерними таблицами (бренды/роялти/территория)

list_fbus(franchisee, brand, limit)

FBU

get_fbu(name)

Один FBU с рабочими адресами

list_assets(franchisee, asset_type, limit)

Транспортные средства/суда

list_cois(franchisee, expiring_within_days, limit)

Сертификаты страхования с фильтром по окну продления

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

Универсальный инструмент для любого типа документа

frappe_get_doc(doctype, name)

Универсальное получение по имени

frappe_count(doctype, filters_json)

Подсчет записей

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

Счета на оплату (Sales Invoices)

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

Записи главной книги

Related MCP server: easypaydirect-mcp

Как работает аутентификация

Взаимодействует с REST API ERPNext от имени пользователя claude-mcp@tourscale.com через API-ключ и секрет (родная схема аутентификации Frappe: Authorization: token <key>:<secret>).

Пользователь имеет роль System Manager в ERPNext. Слой MCP является границей доверия — инструменты выше по своей сути предназначены только для чтения. Не добавляйте инструменты для записи без необходимости; агенты, которым нужно вносить изменения, должны вызывать узкоспециализированные инструменты, а не общие CRUD-операции.

Для смены ключей: повторно выполните поток generate_keys в bench --site erp.tourscale.local console, обновите FRAPPE_API_KEY + FRAPPE_API_SECRET в основной среде и перезапустите ts-frappe-mcp.

Развертывание

  • Контейнер: ts-frappe-mcp в сети tourscale-net

  • Порт: привязан к 127.0.0.1:8096 (только loopback — доступ через локальный клиент агента или SSH-туннель)

  • Запись Compose находится в /opt/tourscale/docker-compose.services.yml

  • Файл окружения: /opt/tourscale/frappe-mcp/.env (загружается из основной среды)

Локальная разработка

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

Затем вызывайте инструменты через любой MCP-клиент (Claude Code, инструменты отладки FastMCP и т.д.).

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