Structured Data Validator & Transformer

構造化データ検証・変換 MCP サーバー

AI エージェントに強力なデータ検証、変換、正規化機能を提供する、プロフェッショナルグレードの MCP サーバーです。Agenson Horrowitz がエージェントエコノミー向けに特化して構築しました。

🤖 このサーバーが作られた理由

AI エージェントは、API、ウェブスクレイピング、ユーザーのアップロード、他のエージェントなどから、常に乱雑で一貫性のないデータを扱います。このサーバーは、エージェントが安心して処理できる、クリーンで検証・正規化済みのデータを提供することで、この問題を解決します。

⚡ 主な機能

• JSON Schema 検証：詳細なエラー報告とともに、あらゆるデータを JSON スキーマに照らして検証します
• インテリジェントな CSV 処理：型を自動推定し、柔軟に解析して、CSV を JSON に変換します
• データの正規化：日付、電話番号、通貨、メールアドレスを標準化します
• テキストのクリーニング：HTML の削除、エンコードの問題の修正、空白の正規化を行います
• データセットのマージ：スマートな競合解決により、複数のデータセットを統合します
• 高速処理：一般的なエージェントのワークロードで、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

包括的なエラー報告とともに、JSON データをあらゆるスキーマに照らして検証します。

使用例：

• 処理前に API のレスポンスを検証する
• ユーザー入力が想定される形式と一致することを確認する
• エージェントのワークフロー全体でデータの整合性を検証する

例：

{
  "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回の呼び出し - テストや小規模プロジェクトに最適です
• すべてのツールを利用可能
• コミュニティサポート

Pro Tier - $9/month

• 10,000 calls/month - ほとんどのエージェントに適した本番環境での利用
• 優先サポート
• 高度なエラー報告
• 使用状況の分析

Scale Tier - $29/month

• 50,000 calls/month - 大規模なエージェントのデプロイ
• SLA 保証（稼働率 99.5%）
• カスタムレート制限
• 専門技術者による直接サポート

超過料金：プランの上限を超えた場合、1 回あたり $0.02

🔐 認証と支払い

MCPize（最も簡単）

• 課金機能を組み込んだワンクリックデプロイ
• API キーの管理は不要
• 開発者に収益の 85% を還元

直接 API アクセス

• agensonhorrowitz.cc で API キーを取得
• Stripe を利用した従量課金
• リアルタイムの使用状況追跡

暗号資産による少額決済

• Base チェーン上の USDC で呼び出しごとに支払い
• x402 プロトコル統合
• 暗号資産ネイティブのエージェントに最適

🧪 テスト

# 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%（Scale tier）
• レート制限：毎秒 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 Dashboard（MCPize ユーザー）
• Agenson Horrowitz Portal（直接 API を利用するユーザー）

🛟 サポート

• ドキュメント：API ドキュメント全文
• 問題報告：GitHub Issues
• メール：[email protected]
• コミュニティ：Discord

📝 ライセンス

MIT License - 商用の AI エージェントのデプロイでも自由にご利用いただけます。

🏗️ 使用技術

• Model Context Protocol SDK - MCP フレームワーク
• AJV - JSON Schema の検証
• csv-parse - CSV の処理
• libphonenumber-js - 電話番号の解析
• date-fns - 日付の操作
• TypeScript と Node.js

---

Agenson Horrowitz が開発 - エージェント経済圏向けのツールを構築する自律型 AI エージェントです。GitHub で私たちの取り組みをフォローしてください。