Frappe Framework의 Model Context Protocol (MCP) 서버의 현대식 컨테이너화된 Python 구현은 FastMCP, uv for Dependency Management, Docker for deploy를 기반으로 합니다.

특징

• Document Operations: Frappe 문서에 대한 전체 CRUD 작업
• Schema Introspection: DocType 필드 정의 및 구조 분석 -Report Generation: Query 보고서, 금융 진술 및 데이터 수출 -Method Calling: Whitelisted Frappe 메소드 실행
• ** 인증**: 보안 API 키/secret 인증

빠른 시작

# 필수품

• 도커 및 도커 컴스
• API credentials를 가진 Frappe 위치에 접근

설정

사용 가능한 MCP 도구

문서 작업

• create_document: 새로운 Frappe 문서 만들기
• get_document: 문서 검색 DocType and name
• update_document: 기존 문서 업데이트
• delete_document: 문서 삭제
• list_documents: 필터가있는 Query 문서
• call_method: Whitelisted Frappe 방법 실행

Schema 운영

• get_doctype_schema: 완전한 DocType 구조
• get_field_options: Link/Select 필드 옵션 받기
• get_doctype_list: DocTypes 목록

Frappe MCP Server (Python + uv + Docker)

A modern, containerized Python implementation of the Model Context Protocol (MCP) server for Frappe Framework, built with FastMCP, uv for dependency management, and Docker for deployment.

Features

• Document Operations: Full CRUD operations for Frappe documents
• Schema Introspection: DocType field definitions and structure analysis
• Report Generation: Query reports, financial statements, and data exports
• Method Calling: Execute whitelisted Frappe methods
• Authentication: Secure API key/secret authentication

Quick Start

Prerequisites

• Docker and Docker Compose
• Access to a Frappe site with API credentials

Setup

git clone https://github.com/appliedrelevance/frappe_mcp_server_uv.git
cd frappe_mcp_server_uv
cp .env.example .env
# Edit .env with your Frappe credentials
docker-compose up -d frappe-mcp-server

Available MCP Tools

Document Operations

• create_document: Create new Frappe documents
• get_document: Retrieve document by DocType and name
• update_document: Update existing documents
• delete_document: Delete documents
• list_documents: Query documents with filters
• call_method: Execute whitelisted Frappe methods

Schema Operations

• get_doctype_schema: Get complete DocType structure
• get_field_options: Get Link/Select field options
• get_doctype_list: List available DocTypes
• get_frappe_usage_info: Combined schema and usage information

Report Operations

• run_query_report: Execute Frappe query reports
• get_report_meta: Get report metadata and structure
• list_reports: List available reports
• run_doctype_report: Generate DocType-based reports
• get_financial_statements: Access P&L, Balance Sheet, Cash Flow

Helper Operations

• ping: Server health check
• version: Get server version information
• validate_auth: Check API credential status

Development

# Install with development dependencies
uv sync --dev

# Run tests
uv run pytest

# Format code
uv run black src/ && uv run isort src/

License

ISC License - see LICENSE file for details.