Frappe MCP Server (Python + uv + Docker)

Frappe框架下的Model Context Protocol (MCP)服务器的现代容器化Python实现，基于FastMCP构建，使用uv进行依赖管理，并通过Docker进行部署。

功能

• 文档操作：对Frappe文档进行完整的CRUD操作
• 模式内省：DocType字段定义和结构分析
• 报告生成：查询报告、财务报表和数据导出
• 方法调用：执行白名单内的Frappe方法
• 认证：安全的API密钥/密钥认证

快速开始

先决条件

• Docker和Docker Compose
• 访问具有API凭证的Frappe站点

配置

git clone https://github.com/appliedrelevance/frappe_mcp_server_uv.git
cd frappe_mcp_server_uv
cp .env.example .env
# 使用您的Frappe凭证编辑.env文件
docker-compose up -d frappe-mcp-server

可用的MCP工具

文档操作

• create_document：创建新的Frappe文档
• get_document：根据DocType和名称检索文档
• update_document：更新现有文档
• delete_document：删除文档
• list_documents：使用过滤器查询文档
• call_method：执行白名单内的Frappe方法

模式操作

• get_doctype_schema：获取完整的DocType结构
• get_field_options：获取Link/Select字段选项
• get_doctype_list：列出可用的DocTypes
• get_frappe_usage_info：组合的模式和使用信息

报告操作

• run_query_report：执行Frappe查询报告
• get_report_meta：获取报告元数据和结构
• list_reports：列出可用的报告
• run_doctype_report：生成基于DocType的报告
• get_financial_statements：访问损益表、资产负债表、现金流量表

辅助操作

• ping：服务器健康检查
• version：获取服务器版本信息
• validate_auth：检查API凭证状态

开发

# 安装开发依赖
uv sync --dev

# 运行测试
uv run pytest

# 格式化代码
uv run black src/ && uv run isort src/

许可证

ISC许可证 - 详情见LICENSE文件。 </中文翻译>