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 分