1. Conduid
  2. RAG
  3. Frappe MCP Server
MCP server · RAG

Frappe MCP Server

by · github.com/appliedrelevance/frappe-mcp-server

Python implementation of Frappe MCP server with advanced filtering, comprehensive API coverage, and custom filter language that bypasses MCP JSON validation limitations

Unclaimed last commit a year ago rag
InstallView source
39Low

Scored 4 days ago · breakdown

About Frappe MCP Server

Frappe MCP Server is an MCP server published by appliedrelevance in the RAG category: python implementation of Frappe MCP server with advanced filtering, comprehensive API coverage, and custom filter language that bypasses MCP JSON validation limitations.

The repository has 17 stars and 12 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/appliedrelevance/frappe-mcp-server

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Frappe MCP Server

Powered by Claude · Grounded in docs

I know everything about Frappe MCP Server. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 2 days ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • !License declaredNo license file. Legally you have no right to use it in a product.
  • ✓Tests presentA test suite exists in the repository.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.

1 check has not been run yet.

README

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.

README fetched from the repository 2 days ago. The original is authoritative.

Questions

About Frappe MCP Server

How do I install Frappe MCP Server?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Frappe MCP Server safe to use with an AI agent?

Its trust score is 39 out of 100 (low). It passes 4 of the 5 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Frappe MCP Server still maintained?

The last commit was a year ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.