tdcv2

AI エージェント向け TDCv2

コーディングエージェントのためのデータジェネレーターです。TDCv2を使って、フェイクデータ、モックデータ、合成データ、テストデータを生成できます。現実的な氏名、メールアドレス、住所、電話番号、IBAN などに対応しています。エージェントが小さな .tdc 設定ファイルを作成し、TDCv2 エンジンがお使いのマシン上で行を生成します。同じ設定ファイルを使えば、実行するたびにバイト単位で同じファイルが生成されます。CSV、JSON、SQL の INSERT 文など、あらゆるテキスト形式に対応し、互いに整合するフィールド、正確な割合、関連テーブル、95 言語・198 か国のデータパックを利用できます。Faker のようなツールですが、データベースのシード、テストフィクスチャ、デモデータなど、データセット全体を生成できます。

2 つの要素を、1 つのバージョンで提供します。

• スキル — エージェントに TDC 言語、ワークフロー、注意点を教えます （skills/tdcv2）。
• MCP サーバー tdcv2-mcp — 同じ機能をツールとして提供します。設定ファイルの検証、生成、データパックの検索とインストール、ファイルの要約、ドキュメントの閲覧ができます（mcp/）。

インストール

Claude Code と Cowork — プラグインにはスキルとサーバーの両方が含まれています。最も簡単な方法は、claude.ai または Claude アプリで Customize → Plugins → Discover を開き、TDCv2 — Fake & Test Data Generator を見つけて Add を選択することです。Claude Code は次のセッションからプラグインを読み込み、最新の状態を保ちます。 または、このリポジトリのマーケットプレイスからインストールします。

claude plugin marketplace add NickLiapin/tdcv2-agents
claude plugin install tdcv2@tdcv2

どちらか一方の方法でインストールしてください。両方を使うとスキルが二重に読み込まれ、サーバーが 2 つ起動します。

Codex、Copilot、Gemini CLI、Cursor など、スキルを読み込めるエージェント — エージェントが参照する場所にスキルを配置します。

npx -y [email protected] install-skill            # ~/.claude/skills/tdcv2
npx -y [email protected] install-skill --agents   # ~/.agents/skills/tdcv2
npx -y [email protected] install-skill --project  # ./.claude/skills/tdcv2
npx -y [email protected] install-skill --dir <skills folder>

任意の MCP クライアント（Claude Desktop、Cursor、VS Code など）：

{ "mcpServers": { "tdcv2": { "command": "npx", "args": ["-y", "[email protected]"] } } }

Windows でクライアントが npx を起動できない場合は、"command": "npx.cmd" を使用してください。Node.js 20 以降が必要です。

各エージェントとクライアントの手順については、AI エージェント向け TDCをご覧ください。

あとは、「CSV 形式で 20 か国から 500 人の顧客」や「50 人の異なるユーザーに対する validate_user の pytest テスト」のように自然な言葉で依頼するだけです。エージェントが設定ファイルを作成し、エンジンで検証してデータを生成し、再現に使える設定ファイルとともにファイルを渡します。

プライバシー

エンジンはローカルで動作します。スキルもサーバーも、データや設定ファイルを外部に送信しません。サーバーは .tdc ファイルを読み込み、起動されたプロジェクトフォルダー内にのみ生成ファイルを書き込みます。

ネットワークアクセスのすべて：

• プラグインは、独自バージョンの npx -y [email protected]（scripts/mcp-launch.mjs）でサーバーを起動します。そのため、初回起動時に指定バージョンとその依存関係（TDCv2 エンジンを含む）が npm レジストリからダウンロードされます。
• 上記のコマンドで実行する npx -y [email protected] … も同様です。また、エージェントが実行する正確なエンジンバージョンである npx -y [email protected] … も同様です。
• 別のバージョンのエンジンを使う場合、エージェントがそのバージョンのドキュメントページを raw.githubusercontent.com から読み込むことがあります。
• データパックは、あなたまたはエージェントが tdcv2 pack add を実行した場合にのみダウンロードされます（サーバー経由では tdc_pack_add を使い、クライアントが許可を求めます）。
• <gen type="http" src="…"> を含む設定ファイルは、誰かがそのような設定ファイルを作成した場合に限り、指定された値をその URL に送信します。

それ以外に取得されるものはなく、何も送信されません。ポリシー全文はPRIVACY.mdをご覧ください。

バージョン

このリリース 0.1.6 は、TDCv2 0.3.6 に対して検証済みです。スキルのリファレンスは、そのバージョンのエンジンのドキュメントから作成されています。別のエンジンバージョンを使う場合、エージェントはそのバージョンのページを読み込み、最終的な判断はエンジン自身の check に委ねられます。

ライセンス

MIT