Structured Data Validator & Transformer

结构化数据验证与转换 MCP 服务

一款专业级 MCP 服务，为 AI Agent 提供强大的数据验证、转换和规范化能力。由 Agenson Horrowitz 专为 Agent 经济打造。

🤖 为什么要创建它

AI Agent 经常要处理来自 API、网页抓取、用户上传以及其他 Agent 的杂乱、不一致的数据。此服务通过提供干净、经过验证和规范化的数据来解决这一问题，让 Agent 能够放心地处理数据。

⚡ 主要功能

• JSON Schema 验证：根据 JSON Schema 验证任意数据，并提供详细的错误报告
• 智能 CSV 处理：将 CSV 转换为 JSON，支持自动推断类型和灵活解析
• 数据规范化：统一日期、电话号码、货币和电子邮件地址的格式
• 文本清理：移除 HTML、修复编码问题、规范空白字符
• 数据集合并：合并多个数据集，并智能解决冲突
• 专为速度打造：针对典型 Agent 工作负载，响应时间低于 2 秒
• 错误处理可靠：优雅处理格式错误的数据，并提供详细的错误消息

🚀 安装

Claude Desktop 配置

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "structured-data-validator": {
      "command": "npx",
      "args": ["@agenson-horrowitz/structured-data-validator-mcp"]
    }
  }
}

Cline 配置

添加到你的 Cline MCP 设置中：

{
  "mcpServers": {
    "structured-data-validator": {
      "command": "npx",
      "args": ["@agenson-horrowitz/structured-data-validator-mcp"]
    }
  }
}

通过 npm 安装

npm install -g @agenson-horrowitz/structured-data-validator-mcp

通过 MCPize 安装（一键部署）

在 MCPize 上即时部署，内置计费和身份验证功能。

🛠️ 可用工具

1. validate_json_schema

根据任意 Schema 验证 JSON 数据，并提供全面的错误报告。

使用场景：

• 处理前验证 API 响应
• 确保用户输入符合预期格式
• 验证 Agent 工作流中的数据完整性

示例：

{
  "data": {"name": "John", "age": "not-a-number"},
  "schema": {
    "type": "object",
    "properties": {
      "name": {"type": "string"},
      "age": {"type": "number"}
    },
    "required": ["name", "age"]
  }
}

2. transform_csv_to_json

将 CSV 数据转换为结构化 JSON，并智能推断类型。

功能：

• 自动检测分隔符（逗号、分号、制表符、竖线）
• 推断数据类型（数字、日期、布尔值）
• 自动处理表头
• 转换过程中清理杂乱数据

示例：

{
  "csv_data": "name,age,active\\nJohn,25,true\\nJane,30,false",
  "options": {
    "infer_types": true,
    "has_headers": true
  }
}

3. normalize_data

统一数据集中常见数据格式。

支持的格式：

• 日期：任意格式 → ISO 8601 或自定义格式
• 电话号码：任意格式 → 国际格式
• 货币：任意格式 → 标准化货币表示法
• 电子邮件地址：验证和规范化

示例：

{
  "data": [
    {"name": "John", "phone": "(555) 123-4567", "date": "12/25/2023"}
  ],
  "fields": {
    "phones": ["phone"],
    "dates": ["date"]
  },
  "target_formats": {
    "date_format": "yyyy-MM-dd",
    "phone_country": "US"
  }
}

4. clean_text

从杂乱的输入中提取干净、规范化的文本。

功能：

• 移除 HTML 标签和实体
• 修复编码问题（弯引号、长破折号等）
• 规范空白字符（可选择保留段落）
• 非常适合清理网页抓取内容

示例：

{
  "text": "<p>Hello &quot;world&quot;</p>\\n\\n\\nExtra   spaces",
  "options": {
    "remove_html": true,
    "normalize_whitespace": true,
    "preserve_paragraphs": false
  }
}

5. merge_datasets

智能合并多个数据集，并解决冲突。

合并策略：

• first_wins：保留每条记录的首次出现
• last_wins：用最新数据覆盖较早的数据
• merge_fields：合并所有来源的字段

示例：

{
  "datasets": [
    [{"id": 1, "name": "John", "email": "[email protected]"}],
    [{"id": 1, "name": "John", "email": "[email protected]", "phone": "+1-555-0123"}]
  ],
  "merge_key": "id",
  "conflict_resolution": "merge_fields"
}

💰 定价

免费套餐

• 每月 500 次调用——适合测试和小型项目
• 包含所有工具
• 社区支持

专业版 - $9/月

• 每月 10,000 次调用 - 满足大多数 Agent 的生产环境使用需求
• 优先支持
• 高级错误报告
• 使用情况分析

扩展版 - $29/月

• 每月 50,000 次调用 - 适用于高调用量的 Agent 部署
• SLA 保障（99.5% 正常运行时间）
• 自定义速率限制
• 直接技术支持

超额费用：超出套餐限额后，每次调用收费 $0.02

🔐 身份验证与付款

MCPize（最简单）

• 一键部署，内置计费功能
• 无需管理 API 密钥
• 开发者可获得 85% 的收入分成

直接 API 访问

• 在 agensonhorrowitz.cc 获取 API 密钥
• 由 Stripe 提供支持的按量计费
• 实时使用情况跟踪

加密货币小额支付

• 使用 Base 链上的 USDC 按次付费
• 集成 x402 协议
• 非常适合原生支持加密货币的 Agent

🧪 测试

# Clone and test locally
git clone https://github.com/agenson-tools/structured-data-validator-mcp
cd structured-data-validator-mcp
npm install
npm run build
npm test

📊 性能

• 平均响应时间：< 2 秒
• 正常运行时间 SLA：99.5%（扩展版）
• 速率限制：10 次调用/秒（可配置）
• 数据限制：每个请求 10MB

🤝 集成示例

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "data-validator": {
      "command": "structured-data-validator-mcp"
    }
  }
}

Cline VS Code 扩展

全局安装后会自动检测。

自定义应用

const { Client } = require('@modelcontextprotocol/sdk/client/index.js');
// Use standard MCP client connection

🔧 API 参考

所有工具均返回一致的响应格式：

{
  "success": true,
  "data": "...",
  "metadata": {
    "processed_count": 100,
    "execution_time_ms": 150
  }
}

错误响应：

{
  "success": false,
  "error": "Detailed error message",
  "tool": "validate_json_schema"
}

📈 使用情况分析

在以下位置监控使用情况：

• MCPize 控制面板（MCPize 用户）
• Agenson Horrowitz 门户（直接 API 用户）

🛟 支持

• 文档：完整 API 文档
• 问题：GitHub Issues
• 电子邮件：[email protected]
• 社区：Discord

📝 许可证

MIT 许可证 - 欢迎将其用于商业 AI Agent 部署。

🏗️ 构建技术

• Model Context Protocol SDK - MCP 框架
• AJV - JSON Schema 验证
• csv-parse - CSV 处理
• libphonenumber-js - 电话号码解析
• date-fns - 日期处理
• TypeScript 与 Node.js

---

由 Agenson Horrowitz 构建 - 为 Agent 经济打造自主 AI Agent 工具。在 GitHub 上关注我们的进展。