tdcv2

Name: tdcv2
Author: NickLiapin

本地服务

github.com/NickLiapin开发工具05 天前更新

代码仓库

关于 tdcv2

tdcv2 为编码 Agent 提供本地合成与测试数据生成引擎，并配有技能和 MCP 服务。通过 .tdc 配置生成可重复的 CSV、JSON、SQL 或文本数据，支持相关字段与多表数据。

主要功能

01本地生成合成与测试数据
02生成 CSV、JSON、SQL 和文本
03配置结果可逐字节复现
04支持关联字段与相关表
05提供 95 种语言和 198 个国家的数据包

适用场景

01创建数据库种子数据
02生成测试夹具
03制作演示数据
04为测试生成多国用户记录

MCP 相关

tdcv2-mcp 向 MCP 客户端提供配置检查、数据生成、数据包查找与安装、文件摘要和文档读取工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y tdcv2-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmtdcv2-mcp0.1.6stdio

工具

收录的工具列表 · 更新于 5 天前

参数	类型	必填	说明
path	string	否	相对于项目文件夹的 .tdc 文件。指定此项或 `config`。
config	string	否	.tdc 配置文本。指定此项或 `path`。

详细介绍

面向 AI Agent 的 TDCv2

为编码 Agent 准备的数据生成器：使用 TDCv2 生成虚假、模拟、合成和测试数据，包括逼真的姓名、电子邮件、地址、电话号码、 IBAN 等。Agent 编写一个小型 .tdc 配置，TDCv2 引擎在你的机器上生成数据行；每次运行时，相同的配置都会生成完全相同的文件，逐字节一致。支持 CSV、JSON、SQL 插入语句或任何文本格式；字段之间相互匹配；精确占比；关联表；适用于 95 种语言和 198 个国家/地区的数据包。可以把它看作适用于整个数据集的 Faker：数据库种子数据、测试固件、演示数据。

两部分，同一版本：

技能——教会 Agent 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

选择一种安装方式，不要同时使用两种——否则技能会加载两次，并启动两个服务。

Codex、Copilot、Gemini CLI、Cursor 和其他能读取技能的 Agent——将技能放到 Agent 会查找的位置：

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 或更高版本。

各 Agent 和客户端的分步说明：面向 AI Agent 的 TDC。

然后用自然语言提出需求——“生成来自 20 个国家/地区的 500 位客户，保存为 CSV”、“为 50 个不同用户的 validate_user 编写一个 pytest 测试”——接下来由 Agent 完成后续工作：编写配置、用引擎检查配置、生成数据，并将文件连同可复现该文件的配置一起交给你。

隐私

引擎在本地运行。技能和服务都不会将你的数据或配置发送到任何地方。服务只会读取 .tdc 文件，并且只会在其启动所在的项目文件夹中写入生成的文件。

所有网络访问如下：

插件通过 npx -y [email protected] 启动服务，使用插件自身的版本（scripts/mcp-launch.mjs）；因此，首次启动时会从 npm 注册表下载该确切版本及其依赖项，包括 TDCv2 引擎；
上述命令中的 npx -y [email protected] … 也会执行相同操作，npx -y [email protected] … 也一样；这是 Agent 运行时使用的确切引擎版本；
如果使用其他版本的引擎，Agent 可能会从 raw.githubusercontent.com 读取该版本的文档页面；
只有当你或 Agent 运行 tdcv2 pack add 时，才会下载数据包（通过服务调用 tdc_pack_add，客户端会请求你允许此操作）；
如果配置中包含 <gen type="http" src="…">，就会将指定的值发送到该 URL——但前提是有人编写了这样的配置。