io.github.rog0x/json

السجل الرسمي البيانات وقواعدها

JSON/YAML/CSV validate, diff, transform for AI agents

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @rog0x/mcp-json-tools
Claude Code
claude mcp add json -- npx -y @rog0x/mcp-json-tools@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "json": {
            "command": "npx",
            "args": [
                "-y",
                "@rog0x/mcp-json-tools@1.0.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. mcp-json-tools
  2. Tools
  3. Installation
  4. Usage with Claude Code
  5. Usage with Claude Desktop
  6. Tool Details
  7. License

mcp-json-tools

An MCP (Model Context Protocol) server that provides JSON and data manipulation tools for AI agents. Designed for use with Claude Code, Claude Desktop, and any MCP-compatible client.

Tools

ToolDescription
json_validateValidate JSON data against a JSON Schema, returning detailed errors with paths
json_diffCompare two JSON objects, showing additions, removals, and changes with paths
json_transformTransform JSON with pick, rename, flatten, and unflatten operations
csv_to_jsonConvert CSV text to a JSON array with configurable headers, delimiters, and type casting
json_to_csvConvert a JSON array of objects to CSV text
yaml_to_jsonConvert YAML text to JSON
json_to_yamlConvert JSON text to YAML

Installation

npm install
npm run build

Usage with Claude Code

claude mcp add json-tools -- node D:/products/mcp-servers/mcp-json-tools/dist/index.js

Usage with Claude Desktop

Add the following to your Claude Desktop configuration file:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "json-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-json-tools/dist/index.js"]
    }
  }
}

Tool Details

json_validate

Validate JSON data against a JSON Schema. Returns a valid boolean and an array of errors, each with the field path, message, and schema keyword that failed.

Parameters:

  • data (string) — JSON data to validate
  • schema (string) — JSON Schema to validate against
json_diff

Compare two JSON objects and produce a structured diff. Each difference includes the dot-notation path, the type of change (added, removed, or changed), and the old/new values.

Parameters:

  • original (string) — Original JSON object
  • modified (string) — Modified JSON object
json_transform

Apply transformations to JSON data. Supports four operations:

  • pick — Extract specific fields by dot-notation paths
  • rename — Rename top-level keys using a mapping object
  • flatten — Flatten nested objects into dot-separated keys
  • unflatten — Restore dot-separated keys into nested objects

Parameters:

  • data (string) — JSON data to transform
  • operation (string) — One of: pick, rename, flatten, unflatten
  • fields (string[]) — For pick: field paths to extract
  • mapping (object) — For rename: old-to-new key mapping
  • separator (string) — For flatten/unflatten: separator character (default: ".")
csv_to_json

Parse CSV text into a JSON array of objects.

Parameters:

  • csv (string) — CSV text to convert
  • hasHeaders (boolean) — Whether the first row is headers (default: true)
  • delimiter (string) — Column delimiter (default: ",")
  • castTypes (boolean) — Auto-cast numbers and booleans (default: false)
json_to_csv

Convert a JSON array of objects to CSV text. Headers are derived from the union of all object keys.

Parameters:

  • data (string) — JSON array to convert
  • delimiter (string) — Column delimiter (default: ",")
  • includeHeaders (boolean) — Include header row (default: true)
yaml_to_json / json_to_yaml

Convert between YAML and JSON formats.

Parameters:

  • yamlText / jsonText (string) — Text to convert
  • indent (number) — Indentation spaces (default: 2)

License

MIT

الأسئلة الشائعة

ما هو io.github.rog0x/json؟

JSON/YAML/CSV validate, diff, transform for AI agents

كيف أثبّت io.github.rog0x/json؟

يعمل على جهازك. في Claude Code: claude mcp add json -- npx -y @rog0x/mcp-json-tools@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.rog0x/json إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.rog0x/json مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.rog0x/json؟

ينشره rog0x. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.