@rog0x/mcp-json-tools 1.0.0

package/dist/tools/json-transform.js

@@ -0,0 +1,176 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerJsonTransform = registerJsonTransform;
+const zod_1 = require("zod");
+function getNestedValue(obj, path) {
+    const parts = path.split(".");
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined || typeof current !== "object") {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+function setNestedValue(obj, path, value) {
+    const parts = path.split(".");
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (!(part in current) || typeof current[part] !== "object" || current[part] === null) {
+            current[part] = {};
+        }
+        current = current[part];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+function pickFields(data, fields) {
+    const result = {};
+    for (const field of fields) {
+        const value = getNestedValue(data, field);
+        if (value !== undefined) {
+            result[field] = value;
+        }
+    }
+    return result;
+}
+function renameFields(data, mapping) {
+    const result = {};
+    for (const [key, value] of Object.entries(data)) {
+        const newKey = mapping[key] || key;
+        result[newKey] = value;
+    }
+    return result;
+}
+function flattenObject(obj, prefix = "", separator = ".") {
+    const result = {};
+    if (obj === null || obj === undefined || typeof obj !== "object") {
+        return result;
+    }
+    if (Array.isArray(obj)) {
+        for (let i = 0; i < obj.length; i++) {
+            const newKey = prefix ? `${prefix}${separator}${i}` : String(i);
+            const val = obj[i];
+            if (typeof val === "object" && val !== null) {
+                Object.assign(result, flattenObject(val, newKey, separator));
+            }
+            else {
+                result[newKey] = val;
+            }
+        }
+        return result;
+    }
+    for (const [key, value] of Object.entries(obj)) {
+        const newKey = prefix ? `${prefix}${separator}${key}` : key;
+        if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+            Object.assign(result, flattenObject(value, newKey, separator));
+        }
+        else if (Array.isArray(value)) {
+            Object.assign(result, flattenObject(value, newKey, separator));
+        }
+        else {
+            result[newKey] = value;
+        }
+    }
+    return result;
+}
+function unflattenObject(obj, separator = ".") {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        const parts = key.split(separator);
+        setNestedValue(result, parts.join("."), value);
+    }
+    return result;
+}
+function registerJsonTransform(server) {
+    server.tool("json_transform", "Apply transformations to a JSON object: pick specific fields, rename keys, flatten nested objects, or unflatten dot-notation keys.", {
+        data: zod_1.z.string().describe("The JSON data to transform (as a JSON string)"),
+        operation: zod_1.z
+            .enum(["pick", "rename", "flatten", "unflatten"])
+            .describe("The transformation operation to apply"),
+        fields: zod_1.z
+            .array(zod_1.z.string())
+            .optional()
+            .describe("For 'pick': array of field paths to extract (supports dot notation like 'user.name')"),
+        mapping: zod_1.z
+            .record(zod_1.z.string(), zod_1.z.string())
+            .optional()
+            .describe("For 'rename': object mapping old key names to new key names"),
+        separator: zod_1.z
+            .string()
+            .optional()
+            .describe("For 'flatten'/'unflatten': separator character (default: '.')"),
+    }, async ({ data, operation, fields, mapping, separator }) => {
+        try {
+            const parsed = JSON.parse(data);
+            let result;
+            const sep = separator || ".";
+            switch (operation) {
+                case "pick": {
+                    if (!fields || fields.length === 0) {
+                        throw new Error("The 'fields' parameter is required for the 'pick' operation");
+                    }
+                    if (Array.isArray(parsed)) {
+                        result = parsed.map((item) => pickFields(item, fields));
+                    }
+                    else {
+                        result = pickFields(parsed, fields);
+                    }
+                    break;
+                }
+                case "rename": {
+                    if (!mapping || Object.keys(mapping).length === 0) {
+                        throw new Error("The 'mapping' parameter is required for the 'rename' operation");
+                    }
+                    if (Array.isArray(parsed)) {
+                        result = parsed.map((item) => renameFields(item, mapping));
+                    }
+                    else {
+                        result = renameFields(parsed, mapping);
+                    }
+                    break;
+                }
+                case "flatten": {
+                    if (Array.isArray(parsed)) {
+                        result = parsed.map((item) => flattenObject(item, "", sep));
+                    }
+                    else {
+                        result = flattenObject(parsed, "", sep);
+                    }
+                    break;
+                }
+                case "unflatten": {
+                    if (Array.isArray(parsed)) {
+                        result = parsed.map((item) => unflattenObject(item, sep));
+                    }
+                    else {
+                        result = unflattenObject(parsed, sep);
+                    }
+                    break;
+                }
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error transforming JSON: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=json-transform.js.map

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

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

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

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

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

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

package/dist/tools/json-validator.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerJsonValidator = registerJsonValidator;
+const zod_1 = require("zod");
+const ajv_1 = __importDefault(require("ajv"));
+function validateJsonAgainstSchema(data, schema) {
+    const ajv = new ajv_1.default({ allErrors: true, verbose: true });
+    const validate = ajv.compile(schema);
+    const valid = validate(data);
+    if (valid) {
+        return { valid: true, errors: [] };
+    }
+    const errors = (validate.errors || []).map((err) => ({
+        path: err.instancePath || "/",
+        message: err.message || "Unknown validation error",
+        keyword: err.keyword,
+        params: err.params,
+    }));
+    return { valid: false, errors };
+}
+function registerJsonValidator(server) {
+    server.tool("json_validate", "Validate a JSON object against a JSON Schema. Returns whether the data is valid and a list of errors with their paths.", {
+        data: zod_1.z.string().describe("The JSON data to validate (as a JSON string)"),
+        schema: zod_1.z
+            .string()
+            .describe("The JSON Schema to validate against (as a JSON string)"),
+    }, async ({ data, schema }) => {
+        try {
+            const parsedData = JSON.parse(data);
+            const parsedSchema = JSON.parse(schema);
+            const result = validateJsonAgainstSchema(parsedData, parsedSchema);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            valid: false,
+                            errors: [
+                                {
+                                    path: "/",
+                                    message: `Parse error: ${message}`,
+                                    keyword: "parse",
+                                    params: {},
+                                },
+                            ],
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=json-validator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json-validator.js","sourceRoot":"","sources":["../../src/tools/json-validator.ts"],"names":[],"mappings":";;;;;AAoCA,sDAsDC;AAzFD,6BAAwB;AACxB,8CAAuC;AAYvC,SAAS,yBAAyB,CAChC,IAAa,EACb,MAA+B;IAE/B,MAAM,GAAG,GAAG,IAAI,aAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE7B,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAgB,EAAE,EAAE,CAAC,CAAC;QAChE,IAAI,EAAE,GAAG,CAAC,YAAY,IAAI,GAAG;QAC7B,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,0BAA0B;QAClD,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,GAAG,CAAC,MAAiC;KAC9C,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC;AAED,SAAgB,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,IAAI,CACT,eAAe,EACf,wHAAwH,EACxH;QACE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QACzE,MAAM,EAAE,OAAC;aACN,MAAM,EAAE;aACR,QAAQ,CAAC,wDAAwD,CAAC;KACtE,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAExC,MAAM,MAAM,GAAG,yBAAyB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YAEnE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;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,IAAI,CAAC,SAAS,CAClB;4BACE,KAAK,EAAE,KAAK;4BACZ,MAAM,EAAE;gCACN;oCACE,IAAI,EAAE,GAAG;oCACT,OAAO,EAAE,gBAAgB,OAAO,EAAE;oCAClC,OAAO,EAAE,OAAO;oCAChB,MAAM,EAAE,EAAE;iCACX;6BACF;yBACF,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

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

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

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

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

package/dist/tools/yaml-json.js

@@ -0,0 +1,75 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerYamlJson = registerYamlJson;
+const zod_1 = require("zod");
+const yaml_1 = __importDefault(require("yaml"));
+function registerYamlJson(server) {
+    server.tool("yaml_to_json", "Convert YAML text to a JSON string.", {
+        yamlText: zod_1.z.string().describe("The YAML text to convert to JSON"),
+        indent: zod_1.z
+            .number()
+            .optional()
+            .describe("JSON indentation spaces (default: 2)"),
+    }, async ({ yamlText, indent }) => {
+        try {
+            const parsed = yaml_1.default.parse(yamlText);
+            const spaces = indent ?? 2;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(parsed, null, spaces),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error converting YAML to JSON: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("json_to_yaml", "Convert a JSON string to YAML text.", {
+        jsonText: zod_1.z.string().describe("The JSON text to convert to YAML"),
+        indent: zod_1.z
+            .number()
+            .optional()
+            .describe("YAML indentation spaces (default: 2)"),
+    }, async ({ jsonText, indent }) => {
+        try {
+            const parsed = JSON.parse(jsonText);
+            const spaces = indent ?? 2;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: yaml_1.default.stringify(parsed, { indent: spaces }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error converting JSON to YAML: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=yaml-json.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-json.js","sourceRoot":"","sources":["../../src/tools/yaml-json.ts"],"names":[],"mappings":";;;;;AAIA,4CA8EC;AAjFD,6BAAwB;AACxB,gDAAwB;AAExB,SAAgB,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,IAAI,CACT,cAAc,EACd,qCAAqC,EACrC;QACE,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QACjE,MAAM,EAAE,OAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,sCAAsC,CAAC;KACpD,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;QAC7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,cAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC;YAE3B,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC;qBAC3C;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,kCAAkC,OAAO,EAAE;qBAClD;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,cAAc,EACd,qCAAqC,EACrC;QACE,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QACjE,MAAM,EAAE,OAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,sCAAsC,CAAC;KACpD,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;QAC7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC;YAE3B,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,cAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;qBACjD;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,kCAAkC,OAAO,EAAE;qBAClD;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@rog0x/mcp-json-tools",
+  "version": "1.0.0",
+  "description": "MCP server providing JSON and data manipulation tools for AI agents",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mcp-json-tools": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch"
+  },
+  "keywords": [
+    "mcp",
+    "json",
+    "tools",
+    "ai",
+    "data-manipulation"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "ajv": "^8.17.1",
+    "json-diff": "^1.0.6",
+    "csv-parse": "^5.6.0",
+    "yaml": "^2.7.0"
+  },
+  "devDependencies": {
+    "@types/json-diff": "^1.0.3",
+    "@types/node": "^22.15.2",
+    "typescript": "^5.8.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerJsonValidator } from "./tools/json-validator.js";
+import { registerJsonDiff } from "./tools/json-diff.js";
+import { registerJsonTransform } from "./tools/json-transform.js";
+import { registerCsvToJson } from "./tools/csv-to-json.js";
+import { registerJsonToCsv } from "./tools/json-to-csv.js";
+import { registerYamlJson } from "./tools/yaml-json.js";
+
+async function main(): Promise<void> {
+  const server = new McpServer({
+    name: "mcp-json-tools",
+    version: "1.0.0",
+  });
+
+  registerJsonValidator(server);
+  registerJsonDiff(server);
+  registerJsonTransform(server);
+  registerCsvToJson(server);
+  registerJsonToCsv(server);
+  registerYamlJson(server);
+
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/src/tools/csv-to-json.ts

@@ -0,0 +1,74 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { parse } from "csv-parse/sync";
+
+export function registerCsvToJson(server: McpServer): void {
+  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: z.string().describe("The CSV text to convert"),
+      hasHeaders: z
+        .boolean()
+        .optional()
+        .describe(
+          "Whether the first row contains column headers (default: true)"
+        ),
+      delimiter: z
+        .string()
+        .optional()
+        .describe("Column delimiter character (default: ','"),
+      castTypes: 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 = parse(csv, {
+          columns: useHeaders ? true : undefined,
+          delimiter: delim,
+          trim: true,
+          skip_empty_lines: true,
+          cast: shouldCast
+            ? (value: string) => {
+                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,
+        }) as unknown[];
+
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: JSON.stringify(records, null, 2),
+            },
+          ],
+        };
+      } catch (error) {
+        const message =
+          error instanceof Error ? error.message : String(error);
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: `Error converting CSV to JSON: ${message}`,
+            },
+          ],
+          isError: true,
+        };
+      }
+    }
+  );
+}

package/src/tools/json-diff.ts

@@ -0,0 +1,151 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { diff } from "json-diff";
+
+interface DiffEntry {
+  path: string;
+  type: "added" | "removed" | "changed";
+  oldValue?: unknown;
+  newValue?: unknown;
+}
+
+function flattenDiff(
+  obj: unknown,
+  basePath: string = ""
+): DiffEntry[] {
+  const entries: DiffEntry[] = [];
+
+  if (obj === undefined || obj === null) {
+    return entries;
+  }
+
+  if (typeof obj !== "object") {
+    return entries;
+  }
+
+  const record = obj as Record<string, unknown>;
+
+  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 as Record<string, unknown>) &&
+      "__new" in (value as Record<string, unknown>)
+    ) {
+      const path = basePath ? `${basePath}.${key}` : key;
+      const typedValue = value as { __old: unknown; __new: unknown };
+      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] as unknown;
+        if (Array.isArray(item) && item.length === 2) {
+          const marker = item[0] as string;
+          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;
+}
+
+export function registerJsonDiff(server: McpServer): void {
+  server.tool(
+    "json_diff",
+    "Compare two JSON objects and show additions, removals, and changes with their paths.",
+    {
+      original: z
+        .string()
+        .describe("The original JSON object (as a JSON string)"),
+      modified: 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 = diff(obj1, obj2);
+
+        if (!rawDiff) {
+          return {
+            content: [
+              {
+                type: "text" as const,
+                text: JSON.stringify(
+                  { identical: true, differences: [] },
+                  null,
+                  2
+                ),
+              },
+            ],
+          };
+        }
+
+        const differences = flattenDiff(rawDiff);
+
+        return {
+          content: [
+            {
+              type: "text" as const,
+              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" as const,
+              text: `Error comparing JSON: ${message}`,
+            },
+          ],
+          isError: true,
+        };
+      }
+    }
+  );
+}