Frappe MCP Server

Frappe MCP Server

mcp-name: io.github.muthanii/frappe_mcp

Frappe Framework 用の Model Context Protocol（MCP）サーバーです。 REST API を介して、Claude Desktop、VS Code Copilot、その他の MCP クライアントを任意の Frappe／ERPNext サイトに接続します。

入手先

配布先	参照	ページ
PyPI	frappe-mcp-server	pypi.org/project/frappe-mcp-server
Docker Hub	muthanii/frappe-mcp	hub.docker.com/r/muthanii/frappe-mcp
GitHub Container Registry	ghcr.io/muthanii/frappe-mcp	ghcr package
MCP Registry	io.github.muthanii/frappe_mcp	registry API
Glama	—	glama.ai/mcp/servers/muthanii/frappe_mcp
ソース	—	github.com/muthanii/frappe_mcp

機能

• ドキュメントの CRUD — Frappe の DocType の取得、作成、更新、削除
• 検索 — 全文検索およびフィルターを使ったドキュメント検索
• リモートメソッドの呼び出し — サーバー側の任意の Python メソッドを実行
• 認証 — API キーとシークレット（トークンベース認証）
• Docker を優先 — docker run コマンド 1 つで実行でき、Python のインストールは不要

クイックスタート

uvx を使用（インストール不要）：

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

pip を使用：

pip install frappe-mcp-server
frappe-mcp-server

Docker を使用（Docker Hub）：

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

Docker を使用（GHCR）：

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

利用可能なツール

すべてのツールには MCP のツール注釈と宣言済みの outputSchema が付属しているため、クライアントは呼び出す前に読み取りツールと破壊的なツールを判別できます。

ツール	説明	アクセス	破壊的	冪等
frappe_ping	接続と認証情報を確認	読み取り専用	いいえ	はい
frappe_get_doc	DocType と名前を指定して単一のドキュメントを取得	読み取り専用	いいえ	はい
frappe_search_docs	フィルターを使ってドキュメントを検索／一覧表示	読み取り専用	いいえ	はい
frappe_create_doc	新しいドキュメントを作成	書き込み	いいえ	いいえ
frappe_update_doc	既存のドキュメントを更新	書き込み	はい	はい
frappe_delete_doc	ドキュメントを削除 — 元に戻せません	書き込み	はい	いいえ
frappe_run_method	許可リストに登録されたサーバー側メソッドを呼び出す	書き込み	はい	いいえ

frappe_run_method の作用は指定したメソッドによって完全に決まるため、破壊的なツールとして分類されています。

設定

環境変数	必須	説明
FRAPPE_URL	はい	Frappe サイトのベース URL（例：https://erp.example.com）
FRAPPE_API_KEY	はい	Frappe API キー
FRAPPE_API_SECRET	はい	Frappe API シークレット
FRAPPE_VERIFY_SSL	いいえ	TLS 検証をスキップするには false を設定します（デフォルト：true）
FRAPPE_TIMEOUT	いいえ	リクエストのタイムアウト（秒）（デフォルト：30）

MCP クライアントの設定

claude_desktop_config.json または Copilot の設定に追加してください。

uvx を使用する場合：

{
  "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"
      }
    }
  }
}

Docker を使用する場合：

{
  "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"
      }
    }
  }
}

ローカル開発

pip install -e .
frappe-mcp

ライセンス

MIT — LICENSE を参照してください。

---