
Snowfakery Mcp
io.github.composable-delivery由 GitHub 帳號 composable-delivery 發布v0.0.6更新於 Oct 24, 2026
MCP server for authoring, analyzing, debugging, and running Snowfakery recipes
概覽
一個本機 MCP 伺服器,讓 AI 助理撰寫、驗證、分析、除錯並執行 Snowfakery YAML 配方,用來產生測試資料。
- 可以做什麼
- 撰寫並驗證 Snowfakery 配方,執行前提供錯誤回饋,並以資源形式提供文件、範例與配方 JSON schema。執行配方並擷取輸出與產出物,方便互動式反覆調整結果。檢查並靜態分析配方以排查問題。列出並取得內建範例配方。產生供 Salesforce 工作流程使用的 CumulusCI 對應檔。
- 適用情境
- 適合需要擬真合成資料或測試資料(尤其是 Salesforce 風格記錄)時,讓助理協助撰寫、檢查與執行 Snowfakery 配方,而不必手動編輯 YAML。對象為 Salesforce 管理員、開發者與資料管線團隊。
- 執行需求
- 以本機程序在使用者電腦上執行,僅限桌面端。需安裝 snowfakery-mcp Python 套件(建議透過 uv),或在 Claude Desktop 使用 .mcpb 套件。未宣告需要帳號、API 金鑰或環境變數。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Snowfakery Mcp,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
Snowfakery MCP Server
Power up your AI workflows with Snowfakery data generation — Use Claude, ChatGPT, and other AI assistants to author, debug, and run data recipes through the Model Context Protocol.
MCP Registry
mcp-name: io.github.composable-delivery/snowfakery-mcp
What is this?
Snowfakery is a YAML-based tool for programmatically generating test data. This MCP server connects Snowfakery to AI assistants, letting you:
- Draft recipes with AI assistance backed by real Snowfakery docs and examples
- Validate recipes before running them with detailed error feedback
- Execute recipes and iterate on results interactively
- Debug issues with static analysis and recipe inspection
- Generate Salesforce mappings for CumulusCI workflows
Perfect for teams that need realistic test data—from Salesforce admins to developers building data pipelines.
Quick Start
Install uv
We recommend using uv for installs and for running from source.
-
Install
uv(macOS/Linux): -
Install
uv(Windows PowerShell):
See the official uv install docs: https://docs.astral.sh/uv/getting-started/installation/
Claude Desktop (recommended)
For Claude Desktop, prefer using the .mcpb bundle from Releases:
- Download the latest
.mcpbfrom https://github.com/composable-delivery/snowfakery-mcp/releases - Add the bundle in Claude Desktop as an MCP server bundle
This bundle includes the pinned runtime metadata (uv.lock, manifest.json) and is the easiest way to get a reproducible setup.
Install & Run (CLI)
Or from source:
Connect to Claude (Desktop)
Add to your Claude Desktop claude_desktop_config.json:
Then ask Claude:
"Show me an example Snowfakery recipe" or "Help me write a recipe to generate 100 Salesforce accounts"
Features
Resources — Access docs, examples, and schemas:
- Snowfakery documentation and recipe examples
- JSON schema for recipe validation
- Run outputs and artifacts
Tools — Interact with recipes:
- Validate & analyze recipes (catch errors early)
- Run recipes and capture output
- List & retrieve example recipes
- Generate CumulusCI mapping files
Learn More
- MCP_SERVER_SPEC.md — detailed design and tool catalog
- Snowfakery docs — recipe language reference
- Contributing — how to contribute
Community
We want this to be welcoming at any level. Questions, ideas, and contributions are always welcome!
- Questions & ideas? Open a GitHub Discussion
- Found a bug? Open an Issue with a minimal recipe
- Want to contribute? See CONTRIBUTING.md
- Security concern? See SECURITY.md
Development
Evals (Agentic Testing)
This repo includes inspect-ai tasks for testing the MCP server with AI models:
See evals/ for more examples and troubleshooting.
Notes
- The repo includes the upstream Snowfakery repo as a git submodule (
Snowfakery/) for development - When running from source, use
uv run ...to ensure the pinned environment - PyPI installs use bundled docs/examples (no submodule required)
Releases
See GitHub Releases for sdist, wheel, and .mcpb bundles (recommended for Claude Desktop).
來源:README.md,提交 b32208b
工具
0版本歷史
1- v0.0.6最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分