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 서버입니다. 에이전트가 가맹점주(Franchisees), 가맹 계약(Franchise Agreements), 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 조회

list_fbus(franchisee, brand, limit)

FBU 목록

get_fbu(name)

운영 주소를 포함한 단일 FBU 조회

list_assets(franchisee, asset_type, limit)

차량/선박 목록

list_cois(franchisee, expiring_within_days, limit)

갱신 기간 필터가 포함된 보험 증명서(COI) 목록

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