Frappe MCP Server

io.github.muthanii由 GitHub 账号 muthanii 发布v1.2.0更新于 Oct 27, 2026

Interact with Frappe/ERPNext sites — document CRUD, search, and whitelisted method calls

已验证STDIO仅桌面数据库商业与电商

概览

AI 生成的概览

通过 REST API 将助手连接到 Frappe/ERPNext 站点，支持文档增删改查、搜索和白名单服务端方法调用。

可以做什么
  • 检查站点连通性与凭据
  • 按 doctype 和名称获取单个文档
  • 按条件搜索和列出文档
  • 创建、更新和删除文档
  • 调用白名单中的服务端 Python 方法
适用场景
当你使用 Frappe 或 ERPNext 站点，希望助手在聊天客户端中直接查询、修改或新建记录，或触发服务端方法时适用。
运行要求
以 stdio 本地进程运行，可通过 uvx、pip 或 Docker 启动。需要 FRAPPE_URL（站点基础地址）、FRAPPE_API_KEY 和 FRAPPE_API_SECRET 进行令牌认证，并能访问该站点网络。可选 FRAPPE_TIMEOUT（默认 30）和 FRAPPE_VERIFY_SSL（默认 true）。
安装前请注意
需要该用户权限范围内的 API key 与 secret；助手可创建、更新和删除文档，删除不可恢复。frappe_run_method 可调用任意白名单服务端方法，效果完全取决于所指定的方法。将 FRAPPE_VERIFY_SSL 设为 false 会跳过 TLS 证书校验。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Frappe MCP Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Frappe MCP Server

[PyPI] [Python] [Docker Hub] [Docker pulls] [GHCR] [MCP Registry] [License]

[frappe_mcp MCP server]

mcp-name: io.github.muthanii/frappe_mcp

A Model Context Protocol (MCP) server for Frappe Framework. Connect Claude Desktop, VS Code Copilot, and other MCP clients to any Frappe/ERPNext site via its REST API.

Where to get it

DistributionReferencePage
PyPIfrappe-mcp-serverpypi.org/project/frappe-mcp-server
Docker Hubmuthanii/frappe-mcphub.docker.com/r/muthanii/frappe-mcp
GitHub Container Registryghcr.io/muthanii/frappe-mcpghcr package
MCP Registryio.github.muthanii/frappe_mcpregistry API
Glama—glama.ai/mcp/servers/muthanii/frappe_mcp
Source—github.com/muthanii/frappe_mcp

Features

  • Document CRUD — get, create, update, delete Frappe doctypes
  • Search — full-text and filtered document search
  • Remote method calls — invoke any server-side Python method
  • Authentication — API key + secret (token-based auth)
  • Docker-first — single docker run command, no Python install needed

Quick start

With uvx (no install):

bash
FRAPPE_URL=https://your-site.com \FRAPPE_API_KEY=your-api-key \FRAPPE_API_SECRET=your-api-secret \  uvx frappe-mcp-server

With pip:

bash
pip install frappe-mcp-serverfrappe-mcp-server

With Docker (Docker Hub):

bash
docker run -i --rm \  -e FRAPPE_URL=https://your-site.com \  -e FRAPPE_API_KEY=your-api-key \  -e FRAPPE_API_SECRET=your-api-secret \  muthanii/frappe-mcp

With Docker (GHCR):

bash
docker run -i --rm \  -e FRAPPE_URL=https://your-site.com \  -e FRAPPE_API_KEY=your-api-key \  -e FRAPPE_API_SECRET=your-api-secret \  ghcr.io/muthanii/frappe-mcp

Available tools

Every tool ships MCP tool annotations and a declared outputSchema, so a client can tell read tools from destructive ones before calling them.

ToolDescriptionAccessDestructiveIdempotent
frappe_pingCheck connectivity and credentialsread-onlynoyes
frappe_get_docRetrieve a single document by doctype + nameread-onlynoyes
frappe_search_docsSearch/list documents with filtersread-onlynoyes
frappe_create_docCreate a new documentwritenono
frappe_update_docUpdate an existing documentwriteyesyes
frappe_delete_docDelete a document — irreversiblewriteyesno
frappe_run_methodCall a whitelisted server-side methodwriteyesno

frappe_run_method is marked destructive because its effect is determined entirely by the method you name.

Configuration

Environment variableRequiredDescription
FRAPPE_URLYesBase URL of your Frappe site (e.g. https://erp.example.com)
FRAPPE_API_KEYYesFrappe API key
FRAPPE_API_SECRETYesFrappe API secret
FRAPPE_VERIFY_SSLNoSet to false to skip TLS verification (default: true)
FRAPPE_TIMEOUTNoRequest timeout in seconds (default: 30)

MCP client config

Add this to your claude_desktop_config.json or Copilot config.

Via uvx:

json
{  "mcpServers": {    "frappe": {      "command": "uvx",      "args": ["frappe-mcp-server"],      "env": {        "FRAPPE_URL": "https://your-site.com",        "FRAPPE_API_KEY": "your-api-key",        "FRAPPE_API_SECRET": "your-api-secret"      }    }  }}

Via Docker:

json
{  "mcpServers": {    "frappe": {      "command": "docker",      "args": [        "run", "-i", "--rm",        "-e", "FRAPPE_URL",        "-e", "FRAPPE_API_KEY",        "-e", "FRAPPE_API_SECRET",        "muthanii/frappe-mcp"      ],      "env": {        "FRAPPE_URL": "https://your-site.com",        "FRAPPE_API_KEY": "your-api-key",        "FRAPPE_API_SECRET": "your-api-secret"      }    }  }}

Local development

bash
pip install -e .frappe-mcp

License

MIT — see LICENSE.

[frappe_mcp MCP server]

来源：README.md，提交 e1f8986

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.2.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分