Metadata-Version: 2.4
Name: iflow-mcp_appliedrelevance_frappe-mcp-server
Version: 0.2.0
Summary: Enhanced Model Context Protocol server for Frappe Framework with comprehensive API operations
Project-URL: Homepage, https://github.com/appliedrelevance/frappe_mcp_server_uv
Project-URL: Repository, https://github.com/appliedrelevance/frappe_mcp_server_uv.git
Project-URL: Issues, https://github.com/appliedrelevance/frappe_mcp_server_uv/issues
Author-email: Applied Relevance <geveritt@appliedrelevance.com>
License: ISC
Keywords: ai,anthropic,claude,erp,frappe,mcp
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: ISC License (ISCL)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.12
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp>=1.13.1
Requires-Dist: pydantic>=2.11.7
Requires-Dist: python-dotenv>=1.1.1
Requires-Dist: zod>=0.8.0
Description-Content-Type: text/markdown

# 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
```bash
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

```bash
# 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.