@rog0x/mcp-json-tools 1.0.0

package/README.md

@@ -0,0 +1,111 @@
+# 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
+
+| Tool | Description |
+|------|-------------|
+| `json_validate` | Validate JSON data against a JSON Schema, returning detailed errors with paths |
+| `json_diff` | Compare two JSON objects, showing additions, removals, and changes with paths |
+| `json_transform` | Transform JSON with pick, rename, flatten, and unflatten operations |
+| `csv_to_json` | Convert CSV text to a JSON array with configurable headers, delimiters, and type casting |
+| `json_to_csv` | Convert a JSON array of objects to CSV text |
+| `yaml_to_json` | Convert YAML text to JSON |
+| `json_to_yaml` | Convert JSON text to YAML |
+
+## Installation
+
+```bash
+npm install
+npm run build
+```
+
+## Usage with Claude Code
+
+```bash
+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`
+
+```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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const json_validator_js_1 = require("./tools/json-validator.js");
+const json_diff_js_1 = require("./tools/json-diff.js");
+const json_transform_js_1 = require("./tools/json-transform.js");
+const csv_to_json_js_1 = require("./tools/csv-to-json.js");
+const json_to_csv_js_1 = require("./tools/json-to-csv.js");
+const yaml_json_js_1 = require("./tools/yaml-json.js");
+async function main() {
+    const server = new mcp_js_1.McpServer({
+        name: "mcp-json-tools",
+        version: "1.0.0",
+    });
+    (0, json_validator_js_1.registerJsonValidator)(server);
+    (0, json_diff_js_1.registerJsonDiff)(server);
+    (0, json_transform_js_1.registerJsonTransform)(server);
+    (0, csv_to_json_js_1.registerCsvToJson)(server);
+    (0, json_to_csv_js_1.registerJsonToCsv)(server);
+    (0, yaml_json_js_1.registerYamlJson)(server);
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAEA,oEAAoE;AACpE,wEAAiF;AACjF,iEAAkE;AAClE,uDAAwD;AACxD,iEAAkE;AAClE,2DAA2D;AAC3D,2DAA2D;AAC3D,uDAAwD;AAExD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,kBAAS,CAAC;QAC3B,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,IAAA,yCAAqB,EAAC,MAAM,CAAC,CAAC;IAC9B,IAAA,+BAAgB,EAAC,MAAM,CAAC,CAAC;IACzB,IAAA,yCAAqB,EAAC,MAAM,CAAC,CAAC;IAC9B,IAAA,kCAAiB,EAAC,MAAM,CAAC,CAAC;IAC1B,IAAA,kCAAiB,EAAC,MAAM,CAAC,CAAC;IAC1B,IAAA,+BAAgB,EAAC,MAAM,CAAC,CAAC;IAEzB,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/csv-to-json.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerCsvToJson(server: McpServer): void;
+//# sourceMappingURL=csv-to-json.d.ts.map

package/dist/tools/csv-to-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-to-json.d.ts","sourceRoot":"","sources":["../../src/tools/csv-to-json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqEzD"}

package/dist/tools/csv-to-json.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCsvToJson = registerCsvToJson;
+const zod_1 = require("zod");
+const sync_1 = require("csv-parse/sync");
+function registerCsvToJson(server) {
+    server.tool("csv_to_json", "Convert CSV text to a JSON array of objects. Supports custom delimiters, header row detection, and automatic type casting.", {
+        csv: zod_1.z.string().describe("The CSV text to convert"),
+        hasHeaders: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Whether the first row contains column headers (default: true)"),
+        delimiter: zod_1.z
+            .string()
+            .optional()
+            .describe("Column delimiter character (default: ','"),
+        castTypes: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Automatically cast numeric and boolean values from strings (default: false)"),
+    }, async ({ csv, hasHeaders, delimiter, castTypes }) => {
+        try {
+            const useHeaders = hasHeaders !== false;
+            const delim = delimiter || ",";
+            const shouldCast = castTypes === true;
+            const records = (0, sync_1.parse)(csv, {
+                columns: useHeaders ? true : undefined,
+                delimiter: delim,
+                trim: true,
+                skip_empty_lines: true,
+                cast: shouldCast
+                    ? (value) => {
+                        if (value === "")
+                            return value;
+                        if (value.toLowerCase() === "true")
+                            return true;
+                        if (value.toLowerCase() === "false")
+                            return false;
+                        const num = Number(value);
+                        if (!isNaN(num) && value.trim() !== "")
+                            return num;
+                        return value;
+                    }
+                    : undefined,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(records, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error converting CSV to JSON: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=csv-to-json.js.map

package/dist/tools/csv-to-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-to-json.js","sourceRoot":"","sources":["../../src/tools/csv-to-json.ts"],"names":[],"mappings":";;AAIA,8CAqEC;AAxED,6BAAwB;AACxB,yCAAuC;AAEvC,SAAgB,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,IAAI,CACT,aAAa,EACb,4HAA4H,EAC5H;QACE,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACnD,UAAU,EAAE,OAAC;aACV,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CACP,+DAA+D,CAChE;QACH,SAAS,EAAE,OAAC;aACT,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,0CAA0C,CAAC;QACvD,SAAS,EAAE,OAAC;aACT,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CACP,6EAA6E,CAC9E;KACJ,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE;QAClD,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,UAAU,KAAK,KAAK,CAAC;YACxC,MAAM,KAAK,GAAG,SAAS,IAAI,GAAG,CAAC;YAC/B,MAAM,UAAU,GAAG,SAAS,KAAK,IAAI,CAAC;YAEtC,MAAM,OAAO,GAAG,IAAA,YAAK,EAAC,GAAG,EAAE;gBACzB,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;gBACtC,SAAS,EAAE,KAAK;gBAChB,IAAI,EAAE,IAAI;gBACV,gBAAgB,EAAE,IAAI;gBACtB,IAAI,EAAE,UAAU;oBACd,CAAC,CAAC,CAAC,KAAa,EAAE,EAAE;wBAChB,IAAI,KAAK,KAAK,EAAE;4BAAE,OAAO,KAAK,CAAC;wBAC/B,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM;4BAAE,OAAO,IAAI,CAAC;wBAChD,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO;4BAAE,OAAO,KAAK,CAAC;wBAClD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;wBAC1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;4BAAE,OAAO,GAAG,CAAC;wBACnD,OAAO,KAAK,CAAC;oBACf,CAAC;oBACH,CAAC,CAAC,SAAS;aACd,CAAc,CAAC;YAEhB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;qBACvC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,iCAAiC,OAAO,EAAE;qBACjD;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/json-diff.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerJsonDiff(server: McpServer): void;
+//# sourceMappingURL=json-diff.d.ts.map

package/dist/tools/json-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-diff.d.ts","sourceRoot":"","sources":["../../src/tools/json-diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoFpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkExD"}

package/dist/tools/json-diff.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerJsonDiff = registerJsonDiff;
+const zod_1 = require("zod");
+const json_diff_1 = require("json-diff");
+function flattenDiff(obj, basePath = "") {
+    const entries = [];
+    if (obj === undefined || obj === null) {
+        return entries;
+    }
+    if (typeof obj !== "object") {
+        return entries;
+    }
+    const record = obj;
+    for (const key of Object.keys(record)) {
+        const value = record[key];
+        if (key.endsWith("__added")) {
+            const cleanKey = key.replace(/__added$/, "");
+            const path = basePath ? `${basePath}.${cleanKey}` : cleanKey;
+            entries.push({ path, type: "added", newValue: value });
+        }
+        else if (key.endsWith("__deleted")) {
+            const cleanKey = key.replace(/__deleted$/, "");
+            const path = basePath ? `${basePath}.${cleanKey}` : cleanKey;
+            entries.push({ path, type: "removed", oldValue: value });
+        }
+        else if (typeof value === "object" &&
+            value !== null &&
+            "__old" in value &&
+            "__new" in value) {
+            const path = basePath ? `${basePath}.${key}` : key;
+            const typedValue = value;
+            entries.push({
+                path,
+                type: "changed",
+                oldValue: typedValue.__old,
+                newValue: typedValue.__new,
+            });
+        }
+        else if (Array.isArray(value)) {
+            const path = basePath ? `${basePath}.${key}` : key;
+            for (let i = 0; i < value.length; i++) {
+                const item = value[i];
+                if (Array.isArray(item) && item.length === 2) {
+                    const marker = item[0];
+                    if (marker === "+") {
+                        entries.push({
+                            path: `${path}[${i}]`,
+                            type: "added",
+                            newValue: item[1],
+                        });
+                    }
+                    else if (marker === "-") {
+                        entries.push({
+                            path: `${path}[${i}]`,
+                            type: "removed",
+                            oldValue: item[1],
+                        });
+                    }
+                    else if (marker === "~") {
+                        entries.push(...flattenDiff(item[1], `${path}[${i}]`));
+                    }
+                }
+            }
+        }
+        else if (typeof value === "object" && value !== null) {
+            const path = basePath ? `${basePath}.${key}` : key;
+            entries.push(...flattenDiff(value, path));
+        }
+    }
+    return entries;
+}
+function registerJsonDiff(server) {
+    server.tool("json_diff", "Compare two JSON objects and show additions, removals, and changes with their paths.", {
+        original: zod_1.z
+            .string()
+            .describe("The original JSON object (as a JSON string)"),
+        modified: zod_1.z
+            .string()
+            .describe("The modified JSON object (as a JSON string)"),
+    }, async ({ original, modified }) => {
+        try {
+            const obj1 = JSON.parse(original);
+            const obj2 = JSON.parse(modified);
+            const rawDiff = (0, json_diff_1.diff)(obj1, obj2);
+            if (!rawDiff) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ identical: true, differences: [] }, null, 2),
+                        },
+                    ],
+                };
+            }
+            const differences = flattenDiff(rawDiff);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            identical: differences.length === 0,
+                            differences,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error comparing JSON: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=json-diff.js.map

package/dist/tools/json-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-diff.js","sourceRoot":"","sources":["../../src/tools/json-diff.ts"],"names":[],"mappings":"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"}

package/dist/tools/json-to-csv.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerJsonToCsv(server: McpServer): void;
+//# sourceMappingURL=json-to-csv.d.ts.map

package/dist/tools/json-to-csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-to-csv.d.ts","sourceRoot":"","sources":["../../src/tools/json-to-csv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyBpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0FzD"}

package/dist/tools/json-to-csv.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerJsonToCsv = registerJsonToCsv;
+const zod_1 = require("zod");
+function escapeCell(value, delimiter) {
+    if (value.includes(delimiter) ||
+        value.includes('"') ||
+        value.includes("\n") ||
+        value.includes("\r")) {
+        return `"${value.replace(/"/g, '""')}"`;
+    }
+    return value;
+}
+function toCsvValue(value) {
+    if (value === null || value === undefined) {
+        return "";
+    }
+    if (typeof value === "object") {
+        return JSON.stringify(value);
+    }
+    return String(value);
+}
+function registerJsonToCsv(server) {
+    server.tool("json_to_csv", "Convert a JSON array of objects to CSV text. Automatically extracts headers from object keys.", {
+        data: zod_1.z
+            .string()
+            .describe("The JSON array to convert (as a JSON string)"),
+        delimiter: zod_1.z
+            .string()
+            .optional()
+            .describe("Column delimiter character (default: ',')"),
+        includeHeaders: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Whether to include a header row (default: true)"),
+    }, async ({ data, delimiter, includeHeaders }) => {
+        try {
+            const parsed = JSON.parse(data);
+            if (!Array.isArray(parsed)) {
+                throw new Error("Input must be a JSON array");
+            }
+            if (parsed.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "",
+                        },
+                    ],
+                };
+            }
+            const delim = delimiter || ",";
+            const withHeaders = includeHeaders !== false;
+            const headerSet = new Set();
+            for (const row of parsed) {
+                if (typeof row === "object" && row !== null && !Array.isArray(row)) {
+                    for (const key of Object.keys(row)) {
+                        headerSet.add(key);
+                    }
+                }
+            }
+            const headers = Array.from(headerSet);
+            const lines = [];
+            if (withHeaders) {
+                lines.push(headers.map((h) => escapeCell(h, delim)).join(delim));
+            }
+            for (const row of parsed) {
+                if (typeof row === "object" && row !== null && !Array.isArray(row)) {
+                    const record = row;
+                    const cells = headers.map((h) => escapeCell(toCsvValue(record[h]), delim));
+                    lines.push(cells.join(delim));
+                }
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: lines.join("\n"),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error converting JSON to CSV: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=json-to-csv.js.map

package/dist/tools/json-to-csv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-to-csv.js","sourceRoot":"","sources":["../../src/tools/json-to-csv.ts"],"names":[],"mappings":"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"}

package/dist/tools/json-transform.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerJsonTransform(server: McpServer): void;
+//# sourceMappingURL=json-transform.d.ts.map

package/dist/tools/json-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-transform.d.ts","sourceRoot":"","sources":["../../src/tools/json-transform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4GpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkH7D"}