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

已驗證STDIO僅桌面開發者工具資料與分析

概覽

AI 產生的概覽

一個本機 MCP 伺服器,讓 AI 助理撰寫、驗證、分析、除錯並執行 Snowfakery YAML 配方,用來產生測試資料。

可以做什麼
撰寫並驗證 Snowfakery 配方,執行前提供錯誤回饋,並以資源形式提供文件、範例與配方 JSON schema。執行配方並擷取輸出與產出物,方便互動式反覆調整結果。檢查並靜態分析配方以排查問題。列出並取得內建範例配方。產生供 Salesforce 工作流程使用的 CumulusCI 對應檔。
適用情境
適合需要擬真合成資料或測試資料(尤其是 Salesforce 風格記錄)時,讓助理協助撰寫、檢查與執行 Snowfakery 配方,而不必手動編輯 YAML。對象為 Salesforce 管理員、開發者與資料管線團隊。
執行需求
以本機程序在使用者電腦上執行,僅限桌面端。需安裝 snowfakery-mcp Python 套件(建議透過 uv),或在 Claude Desktop 使用 .mcpb 套件。未宣告需要帳號、API 金鑰或環境變數。
安裝前請注意
執行配方會在本機執行,並將產生的資料與輸出產出物寫入磁碟,執行前應先檢視配方內容。產生的 CumulusCI 對應檔會寫入檔案。伺服器本身不要求任何憑證。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Snowfakery Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Snowfakery MCP Server

[CI] [PyPI] [License]

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):

    bash
    curl -LsSf https://astral.sh/uv/install.sh | sh
  • Install uv (Windows PowerShell):

    powershell
    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

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:

This bundle includes the pinned runtime metadata (uv.lock, manifest.json) and is the easiest way to get a reproducible setup.

Install & Run (CLI)

bash
# Recommended: isolated installuv tool install snowfakery-mcp
# Then run the serversnowfakery-mcp

Or from source:

bash
git clone https://github.com/composable-delivery/snowfakery-mcp.gitcd snowfakery-mcpuv syncuv run snowfakery-mcp

Connect to Claude (Desktop)

Add to your Claude Desktop claude_desktop_config.json:

json
{  "mcpServers": {    "snowfakery-mcp": {      "command": "snowfakery-mcp"    }  }}

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

Community

We want this to be welcoming at any level. Questions, ideas, and contributions are always welcome!

Development

bash
# Install dev dependenciesuv sync --all-groups
# Run testsuv run pytest
# Type checkuv run mypy snowfakery_mcp
# Lint & formatuv run ruff check snowfakery_mcp tests scripts evalsuv run ruff format snowfakery_mcp tests scripts evals

Evals (Agentic Testing)

This repo includes inspect-ai tasks for testing the MCP server with AI models:

bash
# Install eval dependenciesuv sync --group evals
# Run evaluationuv run inspect eval evals/inspect_tasks.py@snowfakery_mcp_agentic --model openai/gpt-4o-mini

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
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.0.6最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分