seedweaver-mcp

SeedWeaver 🌱

実際のデータベーススキーマから、参照整合性のあるリアルなテストデータを生成します。Claude、Cursor、または任意の MCP クライアントから直接実行できます。

CREATE TABLE SQL（または JSON スキーマ）を貼り付けると、SeedWeaver は外部キーが実際の主キーを参照し、一意制約が守られ、値（名前、メールアドレス、日付、小数）がリアルなシードデータを生成します。統計的にランダムなデータを出力する汎用モックデータツールとは異なり、SeedWeaver はスキーマ内のリレーションシップを理解します。

AI に「このスキーマ用にユーザーを 50 件、注文を 200 件生成して」と頼むだけで、すぐに実行できる INSERT 文が得られます。すべての order.user_id は実在するユーザーを参照します。

---

SeedWeaver を選ぶ理由

ほとんどの「偽データ」ツール（Faker ラッパーやランダム生成ツール）は、スキーマを認識せず、互いに関連のない行を生成します。外部キーがあると、結局はリレーションシップを手作業でつなぐことになります。SeedWeaver なら：

• 外部キーを解決します — 参照先のテーブルを先に生成し（トポロジカル順序）、外部キー列には実際に生成されたキーを設定します。
• 制約を守ります — 一意列と主キーは一意のまま維持され、NOT NULL も尊重されます。
• 実際のスキーマを読み込みます — Postgres/MySQL の CREATE TABLE DDL を直接貼り付けられるため、手動設定は不要です。
• リアルな値を生成します — 名前、メールアドレス、住所、会社名、日付、小数、列挙値。
• 必要な形式で出力します — SQL の INSERT 文、JSON、または CSV。

インストール

npx -y seedweaver-mcp

MCP クライアントの設定（Claude Desktop / Cursor / Windsurf）に追加します：

{
  "mcpServers": {
    "seedweaver": {
      "command": "npx",
      "args": ["-y", "seedweaver-mcp"]
    }
  }
}

ツール

ツール	機能
analyze_schema	スキーマ（SQL DDL または JSON）を解析し、テーブル、列、リレーションシップ、生成順序を報告します。まずこれを実行して、SeedWeaver がスキーマを正しく読み込めていることを確認してください。
generate_seed_data	整合性のあるテストデータを生成します。SQL の INSERT 文（デフォルト）、JSON、または CSV を返します。

例

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

生成されるすべての orders.user_id は、実在する users.id になります。

JSON スキーマから生成する場合（列挙値、範囲、テーブルごとの行数を細かく指定できます）：

{
  "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"] }
      ]
    }
  ]
}

対応する列の型：uuid、serial、int、decimal、boolean、email、fullName、firstName、lastName、username、phone、address、city、country、company、url、word、sentence、paragraph、date、datetime、enum、fk。

---

Free と Pro

無料プランは、小規模なスキーマであればすべての機能を利用できます。Pro では制限がなくなり、実際のプロジェクトや CI に必要な機能が追加されます。

	Free	Pro
スキーマあたりのテーブル数	2	無制限
テーブルあたりの行数	50	無制限
出力形式	SQL、JSON	+ CSV
決定論的シード（再現可能なデータ）	—	✓
カスタムロケール	—	✓
CI / 自動化での利用	—	✓

→ SeedWeaver Pro を入手 — 月額 $19

ライセンスキーを設定して有効化します：

{
  "mcpServers": {
    "seedweaver": {
      "command": "npx",
      "args": ["-y", "seedweaver-mcp"],
      "env": { "SEEDWEAVER_LICENSE": "your-key-here" }
    }
  }
}

---

ライセンス

SeedWeaver MCP サーバーは MIT ライセンスで、無料で実行できます。Pro の機能は有料のライセンスキーで利用できます。Model Context Protocol を使用して構築されています。