Clutter Mcp

clutter-mcp — 合成数据与合成文档生成器（MCP 服务）

这是一个 Model Context Protocol stdio 服务，可让 AI Agent 通过 Clutter 的公共 REST API（使用 API 密钥进行身份验证）驱动完整的 Clutter 流程：构想一家可信的合成公司，批量生成它实际会拥有的文档、电子表格、电子邮件、图像和数据集，轮询任务是否完成，并获取下载 URL。

可用它为开发、测试和演示系统（SharePoint、CRM、文件共享）填充逼真内容——用合成文档和合成数据替代真实内容。按需生成测试数据、演示数据和训练数据，或生成测试文档和训练文档；也可以为 AI Agent 提供可信的数据供其推理，全程无需接触真实或敏感数据。

这是一个轻量级 HTTPS 客户端，不依赖 Clutter 代码库的其余部分。

快速开始

1. 在 https://clutter.run 创建免费账户，打开 Settings，生成 API 密钥（clt_live_…，仅显示一次）。
2. 将服务添加到 MCP 客户端配置中（Claude Code、Claude Desktop 等）：

{
  "mcpServers": {
    "clutter": {
      "command": "npx",
      "args": ["-y", "clutter-mcp"],
      "env": {
        "CLUTTER_API_KEY": "clt_live_…"
      }
    }
  }
}

完成——CLUTTER_API_URL 默认为 https://clutter.run/api，因此只需提供密钥。

配置

环境变量	必需	默认值	说明
CLUTTER_API_KEY	是	—	clt_live_… 密钥（Web 应用 → Settings）
CLUTTER_API_URL	否	https://clutter.run/api	仅在要连接其他部署时覆盖

直接运行

CLUTTER_API_KEY=clt_live_… npx -y clutter-mcp

典型 Agent 工作流

1. build_org — 用一句话描述一家公司 → 返回 orgId（省略 projectId 可自动创建项目）。免费。
2. wait_for_org — 等待公司构建完成，直到状态变为 ready。
3. create_run — 基于该公司生成内容：
   • doc_generator → 一批文档（docx/pdf/xlsx/eml/jpg），按文件夹整理。
   • data_generator → 一个表格数据集（xlsx/csv/json），行数精确。
   • doc_metadata_gen → 为先前文档任务中的每份文档生成一条元数据记录。
4. wait_for_run — 等待任务完成，直到状态变为 complete。
5. 使用 list_run_documents + get_document_url，或使用 build_zip + get_zip_url 将整个任务打包为一个 ZIP（保留文件夹结构，可直接放入 SharePoint 或文件共享）。

工具

• 身份 / 用量： clutter_whoami、get_usage
• 项目： list_projects、create_project、delete_project
• 公司： list_orgs、build_org、get_org、wait_for_org、query_org、delete_org
• 任务： list_runs、create_run、get_run、wait_for_run、list_run_documents、 get_document_url、build_zip、get_zip_url、delete_run

build_org 和 create_run 是异步操作（立即返回一个 ID）；使用 wait_for_* 工具等待任务进入终态，或轮询 get_org / get_run。每个工具都对应一个 REST 端点，并返回原始 JSON 响应。

计费

公司构建、元数据和“询问公司”均免费。新账户可免费获得 10 份文档 + 100 行数据，之后按量付费（所有价格均为美元：每份文档 $0.10，每 10 行数据 $0.06）。create_run 返回 402 表示余额不足——请前往 https://clutter.run/billing 充值。

将内容加载到 SharePoint

Clutter 会提供下载 URL；由你的 Agent 通过 Microsoft Graph 上传。除了简单地“将文件放进文档库”，生成的元数据还可用于驱动自动化——应用敏感度标签、设置权限、分配保留策略、依据元数据将普通文件路由到正确的站点/文档库，甚至自动生成信息架构。包含 Graph 调用的实用示例：https://clutter.run/sharepoint-cookbook.md

Reference

Full REST API: https://clutter.run/api/docs (Swagger UI) · machine-readable guide: https://clutter.run/llms.txt

License

MIT