Real Fake Data

@przeslijmi/real-fake-data-mcp

一个用于 Real Fake Data 的 Model Context Protocol 服务，可按需为 AI 助手（Claude Desktop、Claude Code、Cursor、……）提供逼真的合成测试数据：有效的 PESEL（校验和正确）、NIP、REGON、IBAN、来自真实城市和街道的地址，以及覆盖 27 个欧盟国家的个人和公司名称。

输出_看起来_真实，但都是虚构的，可安全用于预发布环境、演示和种子数据。

• 两个工具，自动更新。 使用 list_generators 发现生成器，使用 generate 按 ID 运行任意生成器。API 上新增的生成器会自动显示，无需升级客户端。
• 轻量且无状态。 通过 HTTPS 调用托管的 Real Fake Data API；不会在本地生成或存储数据。
• 按需使用种子值。 传入 seed 可获得可复现的输出，省略则每次调用都会随机生成。

安装

无需全局安装，只需通过 npx 将 MCP 客户端指向此软件包即可。它通过 stdio 运行，因此客户端会将其作为子进程启动。

Claude Desktop / Claude Code

将其添加到 MCP 服务配置中（claude_desktop_config.json，或通过 claude mcp add）：

{
  "mcpServers": {
    "real-fake-data": {
      "command": "npx",
      "args": ["-y", "@przeslijmi/real-fake-data-mcp"],
      "env": {
        "REAL_FAKE_DATA_API_KEY": "your-api-key"
      }
    }
  }
}

重启客户端后，real-fake-data 工具即可在任何对话中使用。

需要 Node 22+。

配置

客户端通过服务的 env 传递配置：

变量	必需	描述
REAL_FAKE_DATA_API_KEY	否	以 Authorization: Bearer <key> 形式发送的 API 密钥，可将请求纳入按量计费方案。省略则使用匿名通道。
REAL_FAKE_DATA_API_BASE_URL	否	覆盖托管 API 的地址。默认值为 https://api.real-fake-data.com；开发期间可指向本地 API。

工具

list_generators

列出所有可用的生成器及其 id、description 和 supportedLocales。先调用此工具，查看 generate 可接受的 ID。

你： 有哪些虚假数据生成器可用？

Claude (调用 list_generators) → pl.pesel、pl.company、pl.address、any.email、de.company-name、……

generate

运行一个生成器，并返回 API 的 { data, meta } 信封。

参数	类型	描述
generator	string（必需）	list_generators 返回的生成器 ID，例如 pl.pesel 或 any.email。
options	Record<string, string | number | boolean>	生成器专属的查询参数；省略则使用默认值。
count	number	要生成的记录数；省略则生成单条记录。（数量上限由你的方案决定。）
seed	number	用于生成可复现输出的种子值；省略则每次调用都会随机生成。

你： 为我的预发布数据库生成 3 位波兰女性。

Claude (调用 generate，参数为 { generator: "pl.person", count: 3, options: { sex: "f" } }) → 三条包含 { name, surname, initials, birthDate, pesel } 的记录。

options 与生成器在 REST API 上公开的查询参数相同——list_generators 会描述每个参数，API 文档 中列出了完整信息。示例：为 NIP 使用 { "format": "digits-only" }，使用 { "teryt": "14" } 将地址限定在某个地区，使用 { "invalid": true } 获取校验和故意错误的数据，以测试你的验证器。

与 REST API 的关系

此服务是基于同一组托管端点的轻量级 MCP 前端，Playwright 插件和 REST API 也使用这些端点。生成器 ID 会直接映射到路由 — pl.pesel → GET /v1/pl/pesel，any.email → GET /v1/email — 计量方式、计划限制和验证行为都完全相同。想让 AI 助手 通过对话生成测试数据时，请使用此软件包；直接在代码中使用时，请选择 Playwright 插件或 REST API。

许可证

MIT

---

此仓库由系统自动生成，来源于一个私有上游单体仓库。请在此处提交 问题；代码更改会在上游进行，然后重新同步 — 针对此仓库的拉取 请求会应用到上游，而不会直接合并。