Skip to main content
Glama
deenesjakoruzh
tourscale-repos

Frappe MCP

by tourscale-repos
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Frappe MCP

erp.tourscale.com にある TourScale ERPNext / FranOS インスタンス用の読み取り専用 Model Context Protocol サーバーです。エージェントがフランチャイジー、フランチャイズ契約、FBU、資産、COI、および ERPNext の請求書/GLエントリを照会できるようにします。

公開されている機能

ツール

目的

whoami

接続確認 — APIユーザーのIDを返します

list_franchisees(status, brand, limit)

オプションのフィルター付きフランチャイジー一覧

get_franchisee(name)

名前によるフランチャイジーの全ドキュメント取得 (例: FZE-00001)

list_fas(franchisee, status, expiring_within_days, limit)

フランチャイズ契約一覧。コンプライアンス監視用の期限切れウィンドウ指定が可能

get_fa(name)

子テーブル（ブランド/ロイヤリティ/テリトリー）を含むFAを1件取得

list_fbus(franchisee, brand, limit)

FBU一覧

get_fbu(name)

運営住所を含むFBUを1件取得

list_assets(franchisee, asset_type, limit)

車両/船舶一覧

list_cois(franchisee, expiring_within_days, limit)

更新ウィンドウフィルター付きの保険証明書一覧

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

あらゆるDoctypeに対応する汎用的なエスケープハッチ

frappe_get_doc(doctype, name)

名前による汎用的な取得

frappe_count(doctype, filters_json)

レコード数のカウント

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

売上請求書一覧

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

GL元帳エントリ

Related MCP server: easypaydirect-mcp

認証の仕組み

APIキーとシークレットを使用して claude-mcp@tourscale.com ユーザーとして ERPNext REST API と通信します（Frappeネイティブの認証スキーム: Authorization: token <key>:<secret>）。

このユーザーは ERPNext 上で System Manager ロールを持っています。MCPレイヤーが信頼境界となります。上記のツールは設計上、読み取り専用です。書き込みツールを安易に追加しないでください。変更が必要なエージェントは、汎用的なCRUDではなく、目的を絞った特定のツールを呼び出すべきです。

キーをローテーションするには、bench --site erp.tourscale.local console で generate_keys フローを再実行し、マスター環境変数で FRAPPE_API_KEY と FRAPPE_API_SECRET を更新してから、ts-frappe-mcp を再起動してください。

デプロイメント

  • コンテナ: tourscale-net 上の ts-frappe-mcp

  • ポート: 127.0.0.1:8096 にバインド（ループバックのみ — ローカルエージェントクライアントまたは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