{"id":37796582,"url":"https://github.com/composable-delivery/snowfakery-mcp","last_synced_at":"2026-01-18T21:00:36.805Z","repository":{"id":332525705,"uuid":"1132961059","full_name":"composable-delivery/snowfakery-mcp","owner":"composable-delivery","description":"MCP Server for Snowfakery data generation","archived":false,"fork":false,"pushed_at":"2026-01-16T16:18:25.000Z","size":1245,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-17T02:23:06.598Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/composable-delivery.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE-APACHE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":"COPYRIGHT","agents":null,"dco":null,"cla":null}},"created_at":"2026-01-12T17:29:59.000Z","updated_at":"2026-01-16T20:28:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/composable-delivery/snowfakery-mcp","commit_stats":null,"previous_names":["composable-delivery/snowfakery-mcp"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/composable-delivery/snowfakery-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/composable-delivery%2Fsnowfakery-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/composable-delivery%2Fsnowfakery-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/composable-delivery%2Fsnowfakery-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/composable-delivery%2Fsnowfakery-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/composable-delivery","download_url":"https://codeload.github.com/composable-delivery/snowfakery-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/composable-delivery%2Fsnowfakery-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28517929,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T18:55:29.170Z","status":"ssl_error","status_checked_at":"2026-01-17T18:55:03.375Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-16T15:20:51.363Z","updated_at":"2026-01-17T20:42:01.260Z","avatar_url":"https://github.com/composable-delivery.png","language":"Python","funding_links":[],"categories":["カテゴリ"],"sub_categories":["🛠️ \u003ca name=\"developer-tools\"\u003e\u003c/a\u003e開発ツール"],"readme":"# Snowfakery MCP Server\n\n[![CI](https://github.com/composable-delivery/snowfakery-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/composable-delivery/snowfakery-mcp/actions/workflows/ci.yml)\n[![Release](https://github.com/composable-delivery/snowfakery-mcp/actions/workflows/release.yml/badge.svg)](https://github.com/composable-delivery/snowfakery-mcp/actions/workflows/release.yml)\n[![PyPI](https://img.shields.io/pypi/v/snowfakery-mcp.svg)](https://pypi.org/project/snowfakery-mcp/)\n[![Codecov](https://codecov.io/gh/composable-delivery/snowfakery-mcp/branch/main/graph/badge.svg)](https://codecov.io/gh/composable-delivery/snowfakery-mcp)\n[![License](https://img.shields.io/github/license/composable-delivery/snowfakery-mcp.svg)](LICENSE-MIT)\n\n**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](https://modelcontextprotocol.io/).\n\n## MCP Registry\n\nmcp-name: io.github.composable-delivery/snowfakery-mcp\n\n## What is this?\n\n[Snowfakery](https://github.com/SFDO-Tooling/Snowfakery) is a YAML-based tool for programmatically generating test data. This MCP server connects Snowfakery to AI assistants, letting you:\n\n- **Draft recipes** with AI assistance backed by real Snowfakery docs and examples\n- **Validate recipes** before running them with detailed error feedback\n- **Execute recipes** and iterate on results interactively\n- **Debug issues** with static analysis and recipe inspection\n- **Generate Salesforce mappings** for CumulusCI workflows\n\nPerfect for teams that need realistic test data—from Salesforce admins to developers building data pipelines.\n\n## Quick Start\n\n### Install `uv`\n\nWe recommend using `uv` for installs and for running from source.\n\n- Install `uv` (macOS/Linux):\n\n  ```bash\n  curl -LsSf https://astral.sh/uv/install.sh | sh\n  ```\n\n- Install `uv` (Windows PowerShell):\n\n  ```powershell\n  powershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n  ```\n\nSee the official `uv` install docs: \u003chttps://docs.astral.sh/uv/getting-started/installation/\u003e\n\n### Claude Desktop (recommended)\n\nFor Claude Desktop, prefer using the `.mcpb` bundle from Releases:\n\n- Download the latest `.mcpb` from \u003chttps://github.com/composable-delivery/snowfakery-mcp/releases\u003e\n- Add the bundle in Claude Desktop as an MCP server bundle\n\nThis bundle includes the pinned runtime metadata (`uv.lock`, `manifest.json`) and is the easiest way to get a reproducible setup.\n\n### Install \u0026 Run (CLI)\n\n```bash\n# Recommended: isolated install\nuv tool install snowfakery-mcp\n\n# Then run the server\nsnowfakery-mcp\n```\n\nOr from source:\n\n```bash\ngit clone https://github.com/composable-delivery/snowfakery-mcp.git\ncd snowfakery-mcp\nuv sync\nuv run snowfakery-mcp\n```\n\n### Connect to Claude (Desktop)\n\nAdd to your Claude Desktop `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"snowfakery-mcp\": {\n      \"command\": \"snowfakery-mcp\"\n    }\n  }\n}\n```\n\nThen ask Claude:\n\u003e \"Show me an example Snowfakery recipe\" or \"Help me write a recipe to generate 100 Salesforce accounts\"\n\n## Features\n\n**Resources** — Access docs, examples, and schemas:\n\n- Snowfakery documentation and recipe examples\n- JSON schema for recipe validation\n- Run outputs and artifacts\n\n**Tools** — Interact with recipes:\n\n- Validate \u0026 analyze recipes (catch errors early)\n- Run recipes and capture output\n- List \u0026 retrieve example recipes\n- Generate CumulusCI mapping files\n\n## Learn More\n\n- **[MCP_SERVER_SPEC.md](MCP_SERVER_SPEC.md)** — detailed design and tool catalog\n- **[Snowfakery docs](https://snowfakery.readthedocs.io/)** — recipe language reference\n- **[Contributing](CONTRIBUTING.md)** — how to contribute\n\n## Community\n\nWe want this to be welcoming at any level. Questions, ideas, and contributions are always welcome!\n\n- **Questions \u0026 ideas?** Open a [GitHub Discussion](https://github.com/composable-delivery/snowfakery-mcp/discussions)\n- **Found a bug?** [Open an Issue](https://github.com/composable-delivery/snowfakery-mcp/issues) with a minimal recipe\n- **Want to contribute?** See [CONTRIBUTING.md](CONTRIBUTING.md)\n- **Security concern?** See [SECURITY.md](SECURITY.md)\n\n## Development\n\n```bash\n# Install dev dependencies\nuv sync --all-groups\n\n# Run tests\nuv run pytest\n\n# Type check\nuv run mypy snowfakery_mcp\n\n# Lint \u0026 format\nuv run ruff check snowfakery_mcp tests scripts evals\nuv run ruff format snowfakery_mcp tests scripts evals\n```\n\n### Evals (Agentic Testing)\n\nThis repo includes `inspect-ai` tasks for testing the MCP server with AI models:\n\n```bash\n# Install eval dependencies\nuv sync --group evals\n\n# Run evaluation\nuv run inspect eval evals/inspect_tasks.py@snowfakery_mcp_agentic --model openai/gpt-4o-mini\n```\n\nSee [evals/](evals/) for more examples and troubleshooting.\n\n## Notes\n\n- The repo includes the upstream Snowfakery repo as a git submodule (`Snowfakery/`) for development\n- When running from source, use `uv run ...` to ensure the pinned environment\n- PyPI installs use bundled docs/examples (no submodule required)\n\n## Releases\n\nSee [GitHub Releases](https://github.com/composable-delivery/snowfakery-mcp/releases) for sdist, wheel, and `.mcpb` bundles (recommended for Claude Desktop).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcomposable-delivery%2Fsnowfakery-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcomposable-delivery%2Fsnowfakery-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcomposable-delivery%2Fsnowfakery-mcp/lists"}