seedweaver-mcp
Schema-aware relational test data generator - an MCP server that turns your real database schema into coherent fake seed data with working foreign keys. For Claude, Cursor, and any MCP client.
Documentation
SeedWeaver ๐ฑ
Generate realistic, referentially-coherent test data from your real database schema โ straight from Claude, Cursor, or any MCP client.
Paste your `CREATE TABLE` SQL (or a JSON schema) and SeedWeaver generates seed data where foreign keys actually resolve to real primary keys, unique constraints are respected, and values are realistic (names, emails, dates, decimals). Unlike generic mock-data tools that spit out statistically random junk, SeedWeaver understands the *relationships* in your schema.
> Ask your AI: *"Generate 50 users and 200 orders for this schema"* โ and get INSERTs you can run immediately, with every `order.user_id` pointing at a user that exists.
Why SeedWeaver
Most "fake data" tools (Faker wrappers, random generators) give you isolated rows with no awareness of your schema. The moment you have foreign keys, you're back to hand-wiring relationships. SeedWeaver:
- Resolves foreign keys โ referenced tables are generated first (topological ordering), and FK columns point at real generated keys.
- Respects constraints โ unique columns stay unique, primary keys are unique, `NOT NULL` is honored.
- Reads your real schema โ paste Postgres/MySQL `CREATE TABLE` DDL directly, no manual config.
- Realistic values โ names, emails, addresses, companies, dates, decimals, enums.
- Outputs what you need โ SQL `INSERT` statements, JSON, or CSV.
Install
npx -y seedweaver-mcpAdd to your MCP client config (Claude Desktop / Cursor / Windsurf):
{
"mcpServers": {
"seedweaver": {
"command": "npx",
"args": ["-y", "seedweaver-mcp"]
}
}
}Tools
| Tool | What it does |
|---|---|
| `analyze_schema` | Parse a schema (SQL DDL or JSON) and report tables, columns, relationships, and generation order. Run this first to confirm SeedWeaver reads your schema correctly. |
| `generate_seed_data` | Generate coherent test data. Returns SQL `INSERT`s (default), JSON, or CSV. |
Examples
From SQL DDL:
Generate 20 rows of test data for:
CREATE TABLE users (
id UUID PRIMARY KEY,
email VARCHAR(255) UNIQUE NOT NULL,
full_name VARCHAR(100),
created_at TIMESTAMP
);
CREATE TABLE orders (
id SERIAL PRIMARY KEY,
user_id UUID NOT NULL REFERENCES users(id),
total DECIMAL(10,2),
status VARCHAR(20)
);Every generated `orders.user_id` will be a real `users.id`.
From a JSON schema (gives you fine control โ enums, ranges, per-table row counts):
{
"tables": [
{
"name": "users",
"rows": 20,
"columns": [
{ "name": "id", "type": "uuid", "primaryKey": true },
{ "name": "email", "type": "email", "unique": true },
{ "name": "name", "type": "fullName" }
]
},
{
"name": "orders",
"rows": 80,
"columns": [
{ "name": "id", "type": "serial", "primaryKey": true },
{ "name": "user_id", "type": "fk", "references": "users.id" },
{ "name": "total", "type": "decimal", "min": 5, "max": 500 },
{ "name": "status", "type": "enum", "values": ["pending", "paid", "shipped"] }
]
}
]
}Supported column types: `uuid`, `serial`, `int`, `decimal`, `boolean`, `email`, `fullName`, `firstName`, `lastName`, `username`, `phone`, `address`, `city`, `country`, `company`, `url`, `word`, `sentence`, `paragraph`, `date`, `datetime`, `enum`, `fk`.
Free vs. Pro
The free tier is fully functional for small schemas. Pro removes the limits and adds the features you need for real projects and CI.
| Free | Pro | |
|---|---|---|
| Tables per schema | 2 | Unlimited |
| Rows per table | 50 | Unlimited |
| Output formats | SQL, JSON | + CSV |
| Deterministic seeds (reproducible data) | โ | โ |
| Custom locales | โ | โ |
| Use in CI / automation | โ | โ |
**โ Get SeedWeaver Pro** โ $19/mo
Activate by setting your license key:
{
"mcpServers": {
"seedweaver": {
"command": "npx",
"args": ["-y", "seedweaver-mcp"],
"env": { "SEEDWEAVER_LICENSE": "your-key-here" }
}
}
}License
The SeedWeaver MCP server is MIT licensed and free to run. Pro features are unlocked with a paid license key. Built with the Model Context Protocol.
Frequently asked questions
What is seedweaver-mcp?
seedweaver-mcp is Schema-aware relational test data generator - an MCP server that turns your real database schema into coherent fake seed data with working foreign keys. For Claude, Cursor, and any MCP client.
How do I install seedweaver-mcp?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is seedweaver-mcp open source?
Yes โ it is hosted on GitHub at https://github.com/FixtureForge/seedweaver-mcp.
Related MCP tools
Model Context Protocol Servers
The Open-Source Multimodal AI Agent Stack: Connecting Cutting-Edge AI Models and Agent Infra
A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you
MCP server to provide Figma layout information to AI coding agents like Cursor
The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Instant is the best backend for AI-coded apps. You get auth, permissions, storage, presence, and streams โ everything you need to ship apps your users will love.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP