SeedBase MCP server
✓ 인증됨AI 어시스턴트를 통해 데이터베이스용으로 관계를 유지하면서도 현실적이고 개인정보를 보호하는 합성 테스트 데이터를 생성합니다.
다른 이름 marcelglaeser/seedbase-node, seedbase-node, @seedbase/client
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.2.2
- 마지막 커밋
- 2026년 7월 12일
- 라이선스
- MIT
SeedBase MCP란?
AI 어시스턴트를 통해 데이터베이스용으로 관계를 유지하면서도 현실적이고 개인정보를 보호하는 합성 테스트 데이터를 생성합니다.
프로젝트 README에서 생성된 요약
SeedBase MCP server 정보
SeedBase Test Data는 복잡한 데이터베이스 관계를 유지하면서도 개인정보를 보호하는 합성 데이터셋을 생성할 수 있도록 개발자를 지원합니다. SeedBase 플랫폼에 연결하여 사용자는 스키마를 모델링하고 Postgres, MySQL, SQLite용 데이터셋을 생성할 수 있습니다. 이 MCP server는 Claude Desktop 또는 Claude Code와 같은 AI 어시스턴트와 연동되어, 5가지 특정 도구를 통해 데이터 생성 라이프사이클 전체를 관리할 수 있습니다.
사용자는 npx를 사용하여 stdio 방식으로 서버를 로컬에 설정하거나, streamable HTTP 클라이언트를 사용하여 호스팅된 버전에 연결할 수 있습니다. 인증을 위해서는 seedbase.dev에서 발급받은 API key가 필요하며, 이는 환경 변수나 설정 파일을 통해 제공할 수 있습니다. 시스템은 SQL DDL, CSV, JSON 또는 ORM 모델로부터 스키마를 가져오는 기능을 지원합니다. 프로젝트 설정이 완료되면 어시스턴트가 데이터 생성을 실행하고 결과 SQL 파일을 다운로드할 수 있으며, 이를 통해 모든 테이블 간의 외래 키 일관성을 보장합니다.
활용 사례
- 1자동 스키마 가져오기AI 어시스턴트가 원시 SQL DDL 또는 ORM 코드를 사용하여 새로운 프로젝트 스키마를 구축할 수 있습니다.
- 2엔드 투 엔드 데이터 생성AI에게 특정 프로젝트를 일관된 MySQL 테스트 데이터로 채우도록 지시할 수 있습니다.
- 3외래 키 일관성 유지 시딩개발자는 모든 관계형 연결이 유지되는 데이터셋을 만드는 데 이 도구를 사용할 수 있습니다.
- 4Prisma 데이터베이스 시딩단일 명령으로 합성 데이터를 Prisma 관리 워크플로우에 직접 통합할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
SeedBase MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 SeedBase MCP 설치
$ claude mcp add --env 'SEEDBASE_API_KEY=<YOUR_SEEDBASE_API_KEY>' seedbase-node -- npx -y @seedbase/clientCursor에 SeedBase MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"seedbase-node": {
"command": "npx",
"args": [
"-y",
"@seedbase/client"
],
"env": {
"SEEDBASE_API_KEY": "<YOUR_SEEDBASE_API_KEY>"
}
}
}
}VS Code에 SeedBase MCP 설치
.vscode/mcp.json
{
"servers": {
"seedbase-node": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@seedbase/client"
],
"env": {
"SEEDBASE_API_KEY": "<YOUR_SEEDBASE_API_KEY>"
}
}
}
}VS Code CLI에 SeedBase MCP 설치
$ code --add-mcp '{"name":"seedbase-node","type":"stdio","command":"npx","args":["-y","@seedbase/client"],"env":{"SEEDBASE_API_KEY":"<YOUR_SEEDBASE_API_KEY>"}}'Claude Desktop에 SeedBase MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"seedbase-node": {
"command": "npx",
"args": [
"-y",
"@seedbase/client"
],
"env": {
"SEEDBASE_API_KEY": "<YOUR_SEEDBASE_API_KEY>"
}
}
}
}Codex에 SeedBase MCP 설치
$ codex mcp add seedbase-node --env 'SEEDBASE_API_KEY=<YOUR_SEEDBASE_API_KEY>' -- npx -y @seedbase/clientCodex config.toml에 SeedBase MCP 설치
~/.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>"
Gemini CLI에 SeedBase MCP 설치
$ gemini mcp add -s user -e 'SEEDBASE_API_KEY=<YOUR_SEEDBASE_API_KEY>' seedbase-node npx -- -y @seedbase/clientGemini settings.json에 SeedBase MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"seedbase-node": {
"command": "npx",
"args": [
"-y",
"@seedbase/client"
],
"env": {
"SEEDBASE_API_KEY": "<YOUR_SEEDBASE_API_KEY>"
}
}
}
}구성
SEEDBASE_API_KEY필수비밀SeedBase API key (dr_sk_...) — create at https://seedba.se -> Settings -> API keys
| 이름 | 설명 | 유형 |
|---|---|---|
| SEEDBASE_API_KEY | SeedBase API key (dr_sk_...) — create at https://seedba.se -> Settings -> API keys | 필수비밀 |
자동 검사
2026년 11월 15일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능marcelglaeser/seedbase-node is public and reachablegithub.com/marcelglaeser/seedbase-node ↗통과
- 패키지가 이 저장소를 소스로 명시@seedbase/client names marcelglaeser/seedbase-node as sourcenpmjs.com/package/@seedbase/client ↗통과
- 빌드 출처(Sigstore 증명)Sigstore attestation for @seedbase/clientnpmjs.com/package/@seedbase/client/v/0.2.2#provenance ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-07-12github.com/marcelglaeser/seedbase-node ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @seedbase/client통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음1 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답initialize answered with protocol 2025-06-18 in 1122 ms통과
README
GitHub에서 보기@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 질문
SeedBase MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'SEEDBASE_API_KEY=<YOUR_SEEDBASE_API_KEY>' seedbase-node -- npx -y @seedbase/client를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
SeedBase MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
SeedBase는 어떤 데이터베이스를 지원하나요?
생성된 데이터셋을 Postgres, MySQL, SQLite 등에 가져올 수 있습니다.
Prisma와 SeedBase를 어떻게 함께 사용하나요?
seedPrisma 함수를 사용하면 단 한 번의 호출로 Prisma가 관리하는 데이터베이스를 외래 키 관계가 일치하는 현실적인 데이터로 채울 수 있습니다.
서버가 데이터를 로컬에 저장하나요?
아니요, 서버는 stdio 전용이며 로컬에 아무것도 저장하지 않습니다.