{"_id":"@berrydev-ai/json-query-mcp","_rev":"7-abed54b6f9d576991fcb0aee8fb76e34","name":"@berrydev-ai/json-query-mcp","dist-tags":{"latest":"1.0.7"},"versions":{"1.0.0":{"name":"@berrydev-ai/json-query-mcp","version":"1.0.0","keywords":["mcp","json","server","query","jsonpath","model-context-protocol"],"author":{"name":"BerryDev AI"},"license":"MIT","_id":"@berrydev-ai/json-query-mcp@1.0.0","maintainers":[{"name":"coderberry","email":"coderberry@gmail.com"}],"homepage":"https://github.com/berrydev-ai/json-query-mcp#readme","bugs":{"url":"https://github.com/berrydev-ai/json-query-mcp/issues"},"bin":{"json-query-mcp":"dist/index.js"},"dist":{"shasum":"80bbfd74cb436d45633e9b28482b1ac84722d098","tarball":"https://registry.npmjs.org/@berrydev-ai/json-query-mcp/-/json-query-mcp-1.0.0.tgz","fileCount":15,"integrity":"sha512-A2X7Uy4NQZDOU8eQcgapZ9is3e/peiAam+67S5MX3luJFp1DWQxCjCz5d81EJmffZQ7CzvKKzTZSPgZRClZtOA==","signatures":[{"sig":"MEUCIQD5PMIAtpXQT83vLRFe+i+phgeD+oecM6NzmyoxrzQqbwIgbuTVo9hooEcHxQ8BO3CrqLmaSzgPpatvU5ddTX8aQxM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@berrydev-ai%2fjson-query-mcp@1.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":32051},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"6ff868be9853734c1be001a4583dad8e28aec78e","scripts":{"dev":"tsc --watch","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","start":"node dist/index.js","inspector":"npx @modelcontextprotocol/inspector node dist/index.js","prepublishOnly":"npm run build && npm run lint && npm test"},"_npmUser":{"name":"coderberry","email":"coderberry@gmail.com"},"repository":{"url":"git+https://github.com/berrydev-ai/json-query-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for JSON file querying with JSONPath support","directories":{},"_nodeVersion":"18.20.8","dependencies":{"zod":"^3.22.0","jsonpath-plus":"^10.3.0","generate-json-schema":"^1.0.0","@modelcontextprotocol/sdk":"^0.5.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.0.0","eslint":"^8.0.0","ts-jest":"^29.0.0","typescript":"^5.0.0","@types/jest":"^29.0.0","@types/node":"^18.0.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/json-query-mcp_1.0.0_1752242405755_0.35077715974847834","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@berrydev-ai/json-query-mcp","version":"1.0.1","keywords":["mcp","json","server","query","jsonpath","model-context-protocol"],"author":{"name":"BerryDev AI"},"license":"MIT","_id":"@berrydev-ai/json-query-mcp@1.0.1","maintainers":[{"name":"coderberry","email":"coderberry@gmail.com"}],"homepage":"https://github.com/berrydev-ai/json-query-mcp#readme","bugs":{"url":"https://github.com/berrydev-ai/json-query-mcp/issues"},"bin":{"json-query-mcp":"dist/index.js"},"dist":{"shasum":"18f006642f7283d8d2cbfd5958b946dbc745b1b4","tarball":"https://registry.npmjs.org/@berrydev-ai/json-query-mcp/-/json-query-mcp-1.0.1.tgz","fileCount":15,"integrity":"sha512-j26EMo6qtCodLI2LaXeznBUArhZXb35G1rmnWYtpjW5khbqt5oTcE8qyT+z5olk9CtVzTq6QVNF4mXPucwhQPg==","signatures":[{"sig":"MEYCIQCv5lC9wwOgRgOYvQbV5VQ22s/2mVwqE+agHlrXieC4UgIhAKuSHcTPl8JCad+yW/pvAGqp+PbFRb7xUwVYjITIxVnY","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32079},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"928136cd91fece9fe2721ba7bde3c0f68cd00a24","scripts":{"dev":"tsc --watch","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","start":"node dist/index.js","inspector":"npx @modelcontextprotocol/inspector node dist/index.js","prepublishOnly":"npm run build && npm run lint && npm test && chmod +x dist/index.js"},"_npmUser":{"name":"coderberry","email":"coderberry@gmail.com"},"repository":{"url":"git+https://github.com/berrydev-ai/json-query-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for JSON file querying with JSONPath support","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.22.0","jsonpath-plus":"^10.3.0","generate-json-schema":"^1.0.0","@modelcontextprotocol/sdk":"^0.5.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.0.0","eslint":"^8.0.0","ts-jest":"^29.0.0","typescript":"^5.0.0","@types/jest":"^29.0.0","@types/node":"^18.0.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/json-query-mcp_1.0.1_1752245630414_0.937010727329463","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@berrydev-ai/json-query-mcp","version":"1.0.2","keywords":["mcp","json","server","query","jsonpath","model-context-protocol"],"author":{"name":"BerryDev AI"},"license":"MIT","_id":"@berrydev-ai/json-query-mcp@1.0.2","maintainers":[{"name":"coderberry","email":"coderberry@gmail.com"}],"homepage":"https://github.com/berrydev-ai/json-query-mcp#readme","bugs":{"url":"https://github.com/berrydev-ai/json-query-mcp/issues"},"bin":{"json-query-mcp":"dist/index.js"},"dist":{"shasum":"3738575cb9034af12bdc05ca9c74492394e365af","tarball":"https://registry.npmjs.org/@berrydev-ai/json-query-mcp/-/json-query-mcp-1.0.2.tgz","fileCount":15,"integrity":"sha512-TU05ay/XL4evfVhdJ7CWDwwuubMhNCrBQ8d7Z3T1l6y9X1fd2kD7iNUFq863i9m/MlTA2gJBy537ZCbr1kUX+A==","signatures":[{"sig":"MEYCIQCmHvffgkuQULSnAAJwfd7hkpeMZnKLJRePk2jdjbVzzQIhAMwQHOiXnsXe6yUYApbkDotbEwS0E3eibGOA7IsZjHP1","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32449},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"928136cd91fece9fe2721ba7bde3c0f68cd00a24","scripts":{"dev":"tsc --watch","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","start":"node dist/index.js","inspector":"npx @modelcontextprotocol/inspector node dist/index.js","prepublishOnly":"npm run build && npm run lint && npm test && chmod +x dist/index.js"},"_npmUser":{"name":"coderberry","email":"coderberry@gmail.com"},"repository":{"url":"git+https://github.com/berrydev-ai/json-query-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for JSON file querying with JSONPath support","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.22.0","jsonpath-plus":"^10.3.0","generate-json-schema":"^1.0.0","@modelcontextprotocol/sdk":"^0.5.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.0.0","eslint":"^8.0.0","ts-jest":"^29.0.0","typescript":"^5.0.0","@types/jest":"^29.0.0","@types/node":"^18.0.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/json-query-mcp_1.0.2_1752246211475_0.232100145382933","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@berrydev-ai/json-query-mcp","version":"1.0.3","keywords":["mcp","json","server","query","jsonpath","model-context-protocol"],"author":{"name":"BerryDev AI"},"license":"MIT","_id":"@berrydev-ai/json-query-mcp@1.0.3","maintainers":[{"name":"coderberry","email":"coderberry@gmail.com"}],"homepage":"https://github.com/berrydev-ai/json-query-mcp#readme","bugs":{"url":"https://github.com/berrydev-ai/json-query-mcp/issues"},"bin":{"json-query-mcp":"dist/index.js"},"dist":{"shasum":"c82941aca2deb2a7e2cfbdda083016b22ac7b0a9","tarball":"https://registry.npmjs.org/@berrydev-ai/json-query-mcp/-/json-query-mcp-1.0.3.tgz","fileCount":15,"integrity":"sha512-gfiUIM90KFlXjS3/HJ+qf4dGWz/x1bU3/43T3gfMaEuyUR+egckKZo4mZ8NZd9GzA8HJTh7shYNCfQOE6LMTQw==","signatures":[{"sig":"MEUCIQDx0p4BtKM3DoDEDf1Bgnje0lG5Zy/6TS8S6mReYAeBTAIgA9z6JR/uL0VW8vEMRJ9VYmvW5qKSrkpzvR+q26RId8Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35702},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"928136cd91fece9fe2721ba7bde3c0f68cd00a24","scripts":{"dev":"tsc --watch","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","start":"node dist/index.js","inspector":"npx @modelcontextprotocol/inspector node dist/index.js","prepublishOnly":"npm run build && npm run lint && npm test && chmod +x dist/index.js"},"_npmUser":{"name":"coderberry","email":"coderberry@gmail.com"},"repository":{"url":"git+https://github.com/berrydev-ai/json-query-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for JSON file querying with JSONPath support","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.22.0","jsonpath-plus":"^10.3.0","generate-json-schema":"^1.0.0","@modelcontextprotocol/sdk":"^0.5.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.0.0","eslint":"^8.0.0","ts-jest":"^29.0.0","typescript":"^5.0.0","@types/jest":"^29.0.0","@types/node":"^18.0.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/json-query-mcp_1.0.3_1752247099620_0.5865262084012512","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@berrydev-ai/json-query-mcp","version":"1.0.4","keywords":["mcp","json","server","query","jsonpath","model-context-protocol"],"author":{"name":"BerryDev AI"},"license":"MIT","_id":"@berrydev-ai/json-query-mcp@1.0.4","maintainers":[{"name":"coderberry","email":"coderberry@gmail.com"}],"homepage":"https://github.com/berrydev-ai/json-query-mcp#readme","bugs":{"url":"https://github.com/berrydev-ai/json-query-mcp/issues"},"bin":{"json-query-mcp":"dist/index.js"},"dist":{"shasum":"c523de099c24586085de3c5babbbe31c272a2535","tarball":"https://registry.npmjs.org/@berrydev-ai/json-query-mcp/-/json-query-mcp-1.0.4.tgz","fileCount":15,"integrity":"sha512-SpPyGrgNC8gF3cssHqyEZDw8Ns0QeaJUN2r8cuWUUDfch86jMI3kwLPP0ueof1orPxKxqLMPLmSJgCaOYSMT5Q==","signatures":[{"sig":"MEUCIG6ka2TI7JlspT79fh3jzIOYH17XQSZYwl7thDa9Cp7IAiEAxB/8fbtrIfTRbvq6Xy3Y2rRYqco4fqFmWBFWZR/euAs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35689},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"928136cd91fece9fe2721ba7bde3c0f68cd00a24","scripts":{"dev":"tsc --watch","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","start":"node dist/index.js","inspector":"npx @modelcontextprotocol/inspector node dist/index.js","prepublishOnly":"npm run build && npm run lint && npm test && chmod +x dist/index.js"},"_npmUser":{"name":"coderberry","email":"coderberry@gmail.com"},"repository":{"url":"git+https://github.com/berrydev-ai/json-query-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for JSON file querying with JSONPath support","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.22.0","jsonpath-plus":"^10.3.0","generate-json-schema":"^1.0.0","@modelcontextprotocol/sdk":"^0.5.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.0.0","eslint":"^8.0.0","ts-jest":"^29.0.0","typescript":"^5.0.0","@types/jest":"^29.0.0","@types/node":"^18.0.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/json-query-mcp_1.0.4_1752247540398_0.959244871094808","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@berrydev-ai/json-query-mcp","version":"1.0.5","keywords":["mcp","json","server","query","jsonpath","model-context-protocol"],"author":{"name":"BerryDev AI"},"license":"MIT","_id":"@berrydev-ai/json-query-mcp@1.0.5","maintainers":[{"name":"coderberry","email":"coderberry@gmail.com"}],"homepage":"https://github.com/berrydev-ai/json-query-mcp#readme","bugs":{"url":"https://github.com/berrydev-ai/json-query-mcp/issues"},"bin":{"json-query-mcp":"dist/index.js"},"dist":{"shasum":"119478f25866d3feedfd847eeac9b40cca1d6bc6","tarball":"https://registry.npmjs.org/@berrydev-ai/json-query-mcp/-/json-query-mcp-1.0.5.tgz","fileCount":15,"integrity":"sha512-O+pMuP8R/71BZE+cN1XbtpGJokVY/Y9x37b/NVj3TE1ejuE8hCSXsl5ShX5Tt8li0KZSesz1p1TvT+93ac0aHA==","signatures":[{"sig":"MEYCIQDVppUSux4x/AzF4BlMtZQiUBUTqb/N7K0009ph62+nRQIhALVwIuhmV3icIFfvnKNrFKjVzelgZZqFw68jR3I0FRPb","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36574},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"928136cd91fece9fe2721ba7bde3c0f68cd00a24","scripts":{"dev":"tsc --watch","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","start":"node dist/index.js","inspector":"npx @modelcontextprotocol/inspector node dist/index.js","prepublishOnly":"npm run build && npm run lint && npm test && chmod +x dist/index.js"},"_npmUser":{"name":"coderberry","email":"coderberry@gmail.com"},"repository":{"url":"git+https://github.com/berrydev-ai/json-query-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for JSON file querying with JSONPath support","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.22.0","jsonpath-plus":"^10.3.0","generate-json-schema":"^1.0.0","@modelcontextprotocol/sdk":"^0.5.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.0.0","eslint":"^8.0.0","ts-jest":"^29.0.0","typescript":"^5.0.0","@types/jest":"^29.0.0","@types/node":"^18.0.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/json-query-mcp_1.0.5_1752247918279_0.9225600325522201","host":"s3://npm-registry-packages-npm-production"}},"1.0.7":{"name":"@berrydev-ai/json-query-mcp","version":"1.0.7","description":"MCP server for JSON file querying with JSONPath support","main":"dist/index.js","types":"dist/index.d.ts","type":"module","bin":{"json-query-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","test":"jest","lint":"eslint src/**/*.ts","inspector":"npx @modelcontextprotocol/inspector node dist/index.js","prepublishOnly":"npm run build && npm run lint && npm test && chmod +x dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.15.1","generate-json-schema":"^1.0.0","jsonpath-plus":"^10.3.0","zod":"^3.22.0"},"devDependencies":{"@types/jest":"^29.0.0","@types/node":"^18.0.0","@typescript-eslint/eslint-plugin":"^6.0.0","@typescript-eslint/parser":"^6.0.0","eslint":"^8.0.0","jest":"^29.0.0","ts-jest":"^29.0.0","typescript":"^5.0.0"},"keywords":["mcp","json","server","query","jsonpath","model-context-protocol"],"author":{"name":"BerryDev AI"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/berrydev-ai/json-query-mcp.git"},"bugs":{"url":"https://github.com/berrydev-ai/json-query-mcp/issues"},"homepage":"https://github.com/berrydev-ai/json-query-mcp#readme","engines":{"node":">=18.0.0"},"publishConfig":{"access":"public"},"_id":"@berrydev-ai/json-query-mcp@1.0.7","gitHead":"a778949761a81712848efcfa38ae5eded4cc56e3","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-ms7bXiTPz0riS087lcLDmo2ZFaeRidDu2WBQGRKl56ev+4bxKOLMIbvVZzYhl4TQOORhjuWLLKnFNMQw0f0ObA==","shasum":"c8f92f0fb68c141f47df8645dcee33c7b1cd432e","tarball":"https://registry.npmjs.org/@berrydev-ai/json-query-mcp/-/json-query-mcp-1.0.7.tgz","fileCount":15,"unpackedSize":31121,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCRuxyqtqIJFRfQ9ZO5woXepRXdMZi3G5mC8p/u24j01QIhAJF58oiaYYKtWIIL5HTX+SHu2SuBPPdzzucYNYW7Apq5"}]},"_npmUser":{"name":"coderberry","email":"coderberry@gmail.com"},"directories":{},"maintainers":[{"name":"coderberry","email":"coderberry@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/json-query-mcp_1.0.7_1752252464329_0.7594290328310744"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-11T14:00:05.651Z","modified":"2025-07-11T16:47:44.737Z","1.0.0":"2025-07-11T14:00:06.016Z","1.0.1":"2025-07-11T14:53:50.619Z","1.0.2":"2025-07-11T15:03:31.653Z","1.0.3":"2025-07-11T15:18:19.791Z","1.0.4":"2025-07-11T15:25:40.585Z","1.0.5":"2025-07-11T15:31:58.461Z","1.0.7":"2025-07-11T16:47:44.510Z"},"bugs":{"url":"https://github.com/berrydev-ai/json-query-mcp/issues"},"author":{"name":"BerryDev AI"},"license":"MIT","homepage":"https://github.com/berrydev-ai/json-query-mcp#readme","keywords":["mcp","json","server","query","jsonpath","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/berrydev-ai/json-query-mcp.git"},"description":"MCP server for JSON file querying with JSONPath support","maintainers":[{"name":"coderberry","email":"coderberry@gmail.com"}],"readme":"# JSON Query MCP\n\nA Model Context Protocol (MCP) server that provides powerful JSON querying and schema generation capabilities. Built with the official TypeScript SDK for MCP servers and clients.\n\n## What is this?\n\nThis MCP server allows you to query JSON files using JSONPath expressions and generate JSON schemas. It's designed to work with AI assistants like Claude to provide seamless JSON data analysis and manipulation capabilities.\n\n## Why use this?\n\n- **Seamless AI Integration**: Works directly with AI assistants through the Model Context Protocol\n- **Powerful Querying**: Use JSONPath expressions to extract specific data from complex JSON structures\n- **Schema Generation**: automatically generate JSON schemas from your data files\n- **Flexible Configuration**: Support for default file paths to simplify repeated operations\n- **Type Safety**: Built with TypeScript for robust error handling and type checking\n\n## Features\n\n- **JSONPath Querying**: Query JSON data using familiar JSONPath syntax (similar to jq)\n- **Schema Generation**: Generate JSON schemas from existing JSON files\n- **Default File Path**: Configure a default JSON file to avoid specifying paths repeatedly\n- **Error Handling**: Comprehensive error messages for debugging\n- **MCP Standard**: Built on the official Model Context Protocol specification\n\n## Installation\n\n```bash\nnpm install @berrydev-ai/json-query-mcp\n```\n\n## Usage\n\n### Basic Usage\n\nStart the server with a default JSON file:\n\n```bash\nnpx json-query-mcp /path/to/your/data.json\n```\n\nOr start without a default file:\n\n```bash\nnpx json-query-mcp\n```\n\n### Configuration with Claude Desktop\n\nAdd to your Claude Desktop configuration (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"json-query\": {\n      \"command\": \"npx\",\n      \"args\": [\"@berrydev-ai/json-query-mcp\", \"/path/to/your/data.json\"]\n    }\n  }\n}\n```\n\n### Configuration without Default File\n\n```json\n{\n  \"mcpServers\": {\n    \"json-query\": {\n      \"command\": \"npx\",\n      \"args\": [\"@berrydev-ai/json-query-mcp\"]\n    }\n  }\n}\n```\n\n## Available Tools\n\n### query-json\n\nQuery JSON data using JSONPath expressions.\n\n**Parameters:**\n- `filePath` (optional): Path to JSON file. If not provided, uses the default path configured when starting the server.\n- `query` (optional): JSONPath expression to execute. If empty, returns the entire JSON.\n\n**Examples:**\n```javascript\n// Get all book titles\nquery: \"$.store.book[*].title\"\n\n// Get books under $10\nquery: \"$.store.book[?(@.price < 10)]\"\n\n// Get the first book\nquery: \"$.store.book[0]\"\n\n// Get all manager names from divisions\nquery: \"$.organization.divisions.*.manager.name\"\n```\n\n### generate-schema\n\nGenerate a JSON schema from a JSON file.\n\n**Parameters:**\n- `filePath` (optional): Path to JSON file. If not provided, uses the default path configured when starting the server.\n\n**Example Output:**\n```json\n{\n  \"type\": \"object\",\n  \"properties\": {\n    \"name\": { \"type\": \"string\" },\n    \"age\": { \"type\": \"number\" },\n    \"active\": { \"type\": \"boolean\" }\n  },\n  \"required\": [\"name\", \"age\"]\n}\n```\n\n## JSONPath Syntax\n\nThis server supports standard JSONPath expressions:\n\n| Expression | Description |\n|------------|-------------|\n| `$` | Root element |\n| `@` | Current element |\n| `.` or `[]` | Child operator |\n| `..` | Recursive descent |\n| `*` | Wildcard |\n| `[n]` | Array index |\n| `[start:end]` | Array slice |\n| `[?()]` | Filter expression |\n\n### Common JSONPath Examples\n\n```javascript\n// Basic property access\n\"$.name\"                    // Get name property\n\"$.users[0].email\"          // Get first user's email\n\"$.products[*].price\"       // Get all product prices\n\n// Array operations\n\"$.items[0,1]\"              // Get first two items\n\"$.items[1:3]\"              // Get items 1-2 (slice)\n\"$.items[-1]\"               // Get last item\n\n// Filtering\n\"$.products[?(@.price > 100)]\"           // Products over $100\n\"$.users[?(@.active == true)]\"           // Active users\n\"$.orders[?(@.status == 'pending')]\"     // Pending orders\n\n// Recursive search\n\"$..price\"                  // All price properties anywhere\n\"$..book[?(@.isbn)]\"        // All books with ISBN\n```\n\n## Default File Path Feature\n\nWhen you start the server with a default file path, you can omit the `filePath` parameter from tool calls:\n\n```bash\n# Start with default file\nnpx json-query-mcp /data/products.json\n\n# Now you can query without specifying the file path\n# The tools will automatically use /data/products.json\n```\n\nThis is particularly useful when:\n- Working with a single JSON file repeatedly\n- Integrating with AI assistants that make multiple queries\n- Simplifying configuration for end users\n\n## Error Handling\n\nThe server provides detailed error messages for common issues:\n\n- **File not found**: When the specified JSON file doesn't exist\n- **Invalid JSON**: When the file contains malformed JSON\n- **Invalid JSONPath**: When the query expression is malformed\n- **No path configured**: When no file path is provided and no default is set\n\n## Development\n\n### Building from Source\n\n```bash\ngit clone https://github.com/berrydev-ai/json-mcp-server.git\ncd json-mcp-server\nnpm install\nnpm run build\n```\n\n### Running Tests\n\n```bash\nnpm test\n```\n\n### Linting\n\n```bash\nnpm run lint\n```\n\n### Development Mode\n\n```bash\nnpm run dev\n```\n\n## Requirements\n\n- Node.js 18 or higher\n- TypeScript 5.0 or higher\n\n## Dependencies\n\n- `@modelcontextprotocol/sdk`: Official MCP TypeScript SDK\n- `jsonpath-plus`: JSONPath implementation\n- `zod`: Schema validation\n- `generate-json-schema`: JSON schema generation\n\n## License\n\nMIT\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## Support\n\nIf you encounter any issues or have questions, please file an issue on the [GitHub repository](https://github.com/berrydev-ai/json-mcp-server/issues).\n","readmeFilename":"README.md"}