SeedBase MCP server
✓ VerifiziertGeneriere durch einen AI Assistant realistische, beziehungsgetreue und datenschutzkonforme synthetische Testdaten für deine Datenbanken.
Auch bekannt als marcelglaeser/seedbase-node, seedbase-node, @seedbase/client
- Stars
- 0
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 0.2.2
- Letzter Commit
- 12. Juli 2026
- Lizenz
- MIT
Was ist SeedBase MCP?
Generiere durch einen AI Assistant realistische, beziehungsgetreue und datenschutzkonforme synthetische Testdaten für deine Datenbanken.
Zusammenfassung generiert aus dem README des Projekts
Über SeedBase MCP server
SeedBase Test Data ermöglicht es Entwicklern, synthetische, datenschutzkonforme Datensätze zu generieren, die komplexe Datenbankbeziehungen beibehalten. Durch die Verbindung mit der SeedBase Plattform können Nutzer Schemas modellieren und Datensätze für Postgres, MySQL und SQLite erstellen. Der Server arbeitet mit AI Assistenten wie Claude Desktop oder Claude Code zusammen, sodass der gesamte Lebenszyklus der Datengenerierung über fünf spezifische Tools gesteuert werden kann.
Nutzer können den Server lokal via stdio über npx einrichten oder sich über einen Streamable-HTTP Client mit einer gehosteten Version verbinden. Die Authentifizierung erfordert einen API Key von seedbase.dev, der über Umgebungsvariablen oder eine Config bereitgestellt werden kann. Das System unterstützt den Import von Schemas aus SQL DDL, CSV, JSON oder ORM-Modellen. Sobald ein Projekt konfiguriert ist, kann der Assistent die Generierung starten und die resultierenden SQL-Dateien herunterladen, wobei die Foreign-Key-Konsistenz über alle Tabellen hinweg sichergestellt wird.
Was du damit machen kannst
- 1Automatisierter Schema-ImportEin AI Assistent kann rohes SQL DDL oder ORM-Code nehmen, um ein neues Projekt-Schema aufzubauen.
- 2End-to-End DatengenerierungDu kannst eine KI anweisen, ein spezifisches Projekt mit konsistenten MySQL Testdaten zu füllen.
- 3Foreign Key konsistentes SeedingEntwickler können das Tool nutzen, um Datensätze zu erstellen, bei denen alle relationalen Verknüpfungen intakt bleiben.
- 4Prisma Database SeedingIntegiere synthetische Daten direkt in einen von Prisma verwalteten Workflow mit einem einzigen Befehl.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du SeedBase MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenSeedBase MCP in Claude Code installieren
$ claude mcp add --env 'SEEDBASE_API_KEY=<YOUR_SEEDBASE_API_KEY>' seedbase-node -- npx -y @seedbase/clientSeedBase MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"seedbase-node": {
"command": "npx",
"args": [
"-y",
"@seedbase/client"
],
"env": {
"SEEDBASE_API_KEY": "<YOUR_SEEDBASE_API_KEY>"
}
}
}
}SeedBase MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"seedbase-node": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@seedbase/client"
],
"env": {
"SEEDBASE_API_KEY": "<YOUR_SEEDBASE_API_KEY>"
}
}
}
}SeedBase MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"seedbase-node","type":"stdio","command":"npx","args":["-y","@seedbase/client"],"env":{"SEEDBASE_API_KEY":"<YOUR_SEEDBASE_API_KEY>"}}'SeedBase MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"seedbase-node": {
"command": "npx",
"args": [
"-y",
"@seedbase/client"
],
"env": {
"SEEDBASE_API_KEY": "<YOUR_SEEDBASE_API_KEY>"
}
}
}
}SeedBase MCP in Codex installieren
$ codex mcp add seedbase-node --env 'SEEDBASE_API_KEY=<YOUR_SEEDBASE_API_KEY>' -- npx -y @seedbase/clientSeedBase MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.seedbase-node] command = "npx" args = ["-y", "@seedbase/client"] [mcp_servers.seedbase-node.env] SEEDBASE_API_KEY = "<YOUR_SEEDBASE_API_KEY>"
SeedBase MCP in Gemini CLI installieren
$ gemini mcp add -s user -e 'SEEDBASE_API_KEY=<YOUR_SEEDBASE_API_KEY>' seedbase-node npx -- -y @seedbase/clientSeedBase MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"seedbase-node": {
"command": "npx",
"args": [
"-y",
"@seedbase/client"
],
"env": {
"SEEDBASE_API_KEY": "<YOUR_SEEDBASE_API_KEY>"
}
}
}
}Konfiguration
SEEDBASE_API_KEYErforderlichSecretSeedBase API key (dr_sk_...) — create at https://seedba.se -> Settings -> API keys
| Name | Beschreibung | Typ |
|---|---|---|
| SEEDBASE_API_KEY | SeedBase API key (dr_sk_...) — create at https://seedba.se -> Settings -> API keys | ErforderlichSecret |
Automatisierte Checks
Geluften am 15. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarmarcelglaeser/seedbase-node is public and reachablegithub.com/marcelglaeser/seedbase-node ↗Bestanden
- Paket nennt dieses Repository als Quelle@seedbase/client names marcelglaeser/seedbase-node as sourcenpmjs.com/package/@seedbase/client ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)Sigstore attestation for @seedbase/clientnpmjs.com/package/@seedbase/client/v/0.2.2#provenance ↗Bestanden
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-07-12github.com/marcelglaeser/seedbase-node ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from @seedbase/clientBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten1 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-Handshakeinitialize answered with protocol 2025-06-18 in 1122 msBestanden
README
Auf GitHub ansehen@seedbase/client
Generate realistic, relationship-preserving, privacy-safe test data for your databases — and pull it straight into your local or CI database.
Seedbase lives on seedbase.dev: you model (or import) a schema there, generate datasets, and use this package to pull them into Postgres, MySQL, SQLite and more. Schema-aware, foreign-key-correct, reproducible by seed.
This is the Node.js client, a counterpart to the Python SDK.
Install
npm install @seedbase/client
Zero runtime dependencies — pure ESM, built on the native fetch of Node 18+.
Quickstart
import { SeedbaseClient } from "@seedbase/client";
// Token from the argument, $SEEDBASE_TOKEN, or ~/.seedbase/config.json
const client = new SeedbaseClient({ token: "dr_sk_..." });
// Trigger a generation and wait for it to finish
const gen = await client.generate(projectId, { seed: 42, wait: true });
// Download the result (Uint8Array)
const bytes = await client.download(gen.id, { format: "sql" });
import { writeFile } from "node:fs/promises";
await writeFile("dump.sql", bytes);
MCP server (Claude Code, Claude Desktop & friends)
This package ships seedbase-mcp — a zero-dependency Model Context Protocol
server that lets AI assistants generate test data for you. Describe what you
need ("fill my Shop project with MySQL test data") and the assistant drives
SeedBase end-to-end through five tools:
| Tool | What it does |
|---|---|
list_projects |
List your SeedBase projects (id, name, database type) |
create_project |
Create a new, empty project |
import_schema |
Import a schema from SQL DDL (raw pg_dump --schema-only works), CSV/JSON or ORM model code |
get_ddl |
Get a project's schema as CREATE TABLE statements, per dialect |
generate_test_data |
Generate a fresh FK-consistent dataset and return it as SQL (large results are written to a local file, never truncated) |
Hosted (zero install) — point any Streamable-HTTP MCP client at
https://seedbase.dev/mcp with an Authorization: Bearer dr_sk_... header:
claude mcp add-json seedbase '{"type":"http","url":"https://seedbase.dev/mcp","headers":{"Authorization":"Bearer dr_sk_..."}}'
Local via Claude Code (stdio):
claude mcp add-json seedbase '{"type":"stdio","command":"npx","args":["-y","-p","@seedbase/client","seedbase-mcp"],"env":{"SEEDBASE_API_KEY":"dr_sk_..."}}'
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"seedbase": {
"command": "npx",
"args": ["-y", "-p", "@seedbase/client", "seedbase-mcp"],
"env": { "SEEDBASE_API_KEY": "dr_sk_..." }
}
}
}
Create a free account at seedbase.dev/register (no
credit card), then create an API key under Settings → API keys. The free tier is
enough to generate full, foreign-key-consistent datasets. The server is stdio-only,
talks exclusively to https://seedbase.dev, and stores nothing locally.
Authentication
The token is resolved in this order:
- The
tokenoption passed to the constructor. - The
SEEDBASE_TOKENenvironment variable. - The
tokenfield in~/.seedbase/config.json(written byseedbase login).
API keys with the dr_sk_ prefix are sent as Authorization: Bearer ..., other
tokens as Authorization: Token .... Get a key at
seedbase.dev/settings?tab=api-keys.
API
new SeedbaseClient({
token, // optional, see resolution order above
apiUrl, // default "https://seedbase.dev/api/v1" (https enforced, http only for localhost)
configPath, // override ~/.seedbase/config.json
requestTimeout, // per-request timeout in ms, default 30000
fetch, // inject a custom fetch (e.g. for tests)
});
| Method | Description |
|---|---|
listProjects() |
All datasets/projects (paginated, followed automatically). |
getProject(projectId) |
A single project. |
listGenerations(projectId) |
Generations for a project (paginated). |
getGeneration(generationId) |
A single generation. |
generate(projectId, opts) |
Trigger a generation. opts: { seed, rows, format, rebaseTo, wait, timeout, pollInterval }. With wait: true it polls until the generation reaches completed/failed/cancelled. |
download(generationId, { format }) |
Download the generated artifact as a Uint8Array. format defaults to "sql". |
seededRows(projectId, { seed, rows }) |
Generate and return the rows as { tableName: [row, ...] }, in foreign-key-safe order. |
exportConfig(projectId) |
The project's engine config as an object. |
importConfig(projectId, config) |
Replace the project's engine config. |
All methods are async and return Promises. Failures throw a SeedbaseError
(with .statusCode for HTTP errors), carrying a readable message that includes
the server's detail or field errors.
import { SeedbaseError } from "@seedbase/client";
try {
await client.getProject("missing");
} catch (err) {
if (err instanceof SeedbaseError) {
console.error(err.statusCode, err.message);
}
}
Prisma seed
Fill a Prisma-managed database with realistic, foreign-key-consistent data, in
one call. Your schema must already exist (your prisma migrate owns it);
SeedBase only fills it. Free tier.
// prisma/seed.ts
import { PrismaClient } from "@prisma/client";
import { SeedbaseClient } from "@seedbase/client";
import { seedPrisma } from "@seedbase/client/prisma";
const prisma = new PrismaClient();
const client = new SeedbaseClient({ token: process.env.SEEDBASE_TOKEN });
await seedPrisma(prisma, client, { project: process.env.SEEDBASE_PROJECT, seed: 42 });
Then run prisma db seed. A runnable demo (offline, no account) is in
examples/prisma-seed-demo.mjs.
Links
- Website: https://seedbase.dev
- Docs: https://seedbase.dev/docs
- API keys: https://seedbase.dev/settings?tab=api-keys
MIT licensed.
SeedBase MCP Fragen
Wie füge ich SeedBase MCP zu Claude Code hinzu?
Führe claude mcp add --env 'SEEDBASE_API_KEY=<YOUR_SEEDBASE_API_KEY>' seedbase-node -- npx -y @seedbase/client in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich SeedBase MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Datenbanken unterstützt SeedBase?
Du kannst generierte Datensätze in Postgres, MySQL, SQLite und mehr importieren.
Wie kann ich SeedBase mit Prisma nutzen?
Du kannst die seedPrisma Funktion nutzen, um eine von Prisma verwaltete Datenbank mit einem einzigen Aufruf mit realistischen, auf Foreign Keys konsistenten Daten zu füllen.
Speichert der Server meine Daten lokal?
Nein, der Server arbeitet rein über stdio und speichert nichts lokal.