{"_id":"@berrydev-ai/json-mcp-server","_rev":"2-5af604e82af87c2fbff5a48c360cfc5a","name":"@berrydev-ai/json-mcp-server","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"@berrydev-ai/json-mcp-server","version":"1.0.0","keywords":["mcp","json","jq","schema","validation","model-context-protocol"],"author":{"url":"eric@berrydev.ai","name":"Eric Berry"},"license":"ISC","_id":"@berrydev-ai/json-mcp-server@1.0.0","maintainers":[{"name":"coderberry","email":"coderberry@gmail.com"}],"homepage":"https://github.com/berrydev-ai/json-mcp-server#readme","bugs":{"url":"https://github.com/berrydev-ai/json-mcp-server/issues"},"bin":{"json-mcp-server":"index.js"},"dist":{"shasum":"3bddc5e5095f40e32402c32ed96a38cc2b26d47c","tarball":"https://registry.npmjs.org/@berrydev-ai/json-mcp-server/-/json-mcp-server-1.0.0.tgz","fileCount":3,"integrity":"sha512-GScsrML4c0qowSWAHm86eVW8Jxwa1/8/3o8N5aH8nOZarHqopgfbNECarpus+mxWKdGzo/hXEFFT2GHCincS0Q==","signatures":[{"sig":"MEUCIF+cmtbjpR90d2net5YSWL05WfJuqXIYYDafDtkn9TM6AiEA+CBgv4QCBov2HqDqiv76YnlTrFM5tCvLdlcSvMQxgI8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36081},"main":"index.js","type":"module","gitHead":"31e574f837dea67ef42753226bfdee1028c536c3","scripts":{"dev":"node index.js --verbose=true","test":"node test.js","start":"node index.js","inspect:local":"npx @modelcontextprotocol/inspector --config config.json --server json-mcp-server-local","release:major":"npm version major","release:minor":"npm version minor","release:patch":"npm version patch","inspect:published":"npx @modelcontextprotocol/inspector --config config.json --server json-mcp-server"},"_npmUser":{"name":"coderberry","email":"coderberry@gmail.com"},"repository":{"url":"git+https://github.com/berrydev-ai/json-mcp-server.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server providing JSON querying, schema generation, and validation tools","directories":{},"_nodeVersion":"22.14.0","dependencies":{"ajv":"^8.17.1","which":"^4.0.0","node-jq":"^6.0.1","commander":"^12.1.0","genson-js":"^0.0.8","@aws-sdk/client-s3":"^3.658.1","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"packageManager":"pnpm@10.13.1","_npmOperationalInternal":{"tmp":"tmp/json-mcp-server_1.0.0_1753840020746_0.039273200887462334","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@berrydev-ai/json-mcp-server","version":"1.1.0","description":"MCP server providing JSON querying, schema generation, and validation tools","type":"module","main":"index.js","bin":{"json-mcp-server":"index.js"},"scripts":{"start":"node index.js","dev":"node index.js --verbose=true","start:http":"node index.js --transport=http --verbose=true","dev:http":"node index.js --transport=http --verbose=true --port=3000","test":"node test.js","inspect:local":"npx @modelcontextprotocol/inspector --config config.json --server json-mcp-server-local","inspect:published":"npx @modelcontextprotocol/inspector --config config.json --server json-mcp-server","inspect:http":"npx @modelcontextprotocol/inspector --config config.json --server json-mcp-server-http","release:patch":"npm version patch","release:minor":"npm version minor","release:major":"npm version major"},"dependencies":{"@aws-sdk/client-s3":"^3.658.1","@modelcontextprotocol/sdk":"^1.0.0","ajv":"^8.17.1","commander":"^12.1.0","cors":"^2.8.5","express":"^4.19.2","genson-js":"^0.0.8","node-jq":"^6.0.1","which":"^4.0.0"},"keywords":["mcp","json","jq","schema","validation","model-context-protocol"],"author":{"name":"Eric Berry","url":"eric@berrydev.ai"},"license":"ISC","repository":{"type":"git","url":"git+https://github.com/berrydev-ai/json-mcp-server.git"},"bugs":{"url":"https://github.com/berrydev-ai/json-mcp-server/issues"},"homepage":"https://github.com/berrydev-ai/json-mcp-server#readme","packageManager":"pnpm@10.13.1","_id":"@berrydev-ai/json-mcp-server@1.1.0","gitHead":"974a605b371509b8e84877eaf9c96a285f0a5010","_nodeVersion":"20.19.3","_npmVersion":"10.8.2","dist":{"integrity":"sha512-FkVZHePBk0YHbO2anVqkvTvj9tyuFpFIF9ymQL62BttT3G3GU8LMweCmFVJZ8LrRwV5vDeu0fgTILOoD2j1k1A==","shasum":"74dd719292129de0c566600541a4e4bbf1dcdaff","tarball":"https://registry.npmjs.org/@berrydev-ai/json-mcp-server/-/json-mcp-server-1.1.0.tgz","fileCount":3,"unpackedSize":36790,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC11S+Fnawbsoynj2KBwBndH9x33wDtx9o0UiQvPh8fcgIgExeEHllic7i1LzJuEsEV1caAizkVhRcADfxbY9szb44="}]},"_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-mcp-server_1.1.0_1753999843187_0.8416826257964245"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-30T01:47:00.616Z","modified":"2025-07-31T22:10:43.595Z","1.0.0":"2025-07-30T01:47:00.972Z","1.1.0":"2025-07-31T22:10:43.379Z"},"bugs":{"url":"https://github.com/berrydev-ai/json-mcp-server/issues"},"author":{"name":"Eric Berry","url":"eric@berrydev.ai"},"license":"ISC","homepage":"https://github.com/berrydev-ai/json-mcp-server#readme","keywords":["mcp","json","jq","schema","validation","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/berrydev-ai/json-mcp-server.git"},"description":"MCP server providing JSON querying, schema generation, and validation tools","maintainers":[{"name":"coderberry","email":"coderberry@gmail.com"}],"readme":"# JSON MCP Server\n\nNode.js server implementing Model Context Protocol (MCP) for JSON operations.\n\n## Features\n\n- Query JSON files using jq notation with complex filters and transformations\n- Generate JSON schemas automatically from existing JSON data\n- Validate JSON schemas to ensure they are properly formed\n- S3 sync support for remote JSON file synchronization\n- Support for both stdio and HTTP transport protocols\n\n**Note**: The server requires `jq` binary to be installed on your system and will only allow operations on files with absolute paths.\n\n## Prerequisites\n\n**🚨 Required: Install jq binary on your system**\n\n**macOS:**\n```bash\nbrew install jq\n```\n\n**Linux:**\n```bash\n# Ubuntu/Debian\nsudo apt-get install jq\n\n# CentOS/RHEL/Fedora\nsudo yum install jq  # or sudo dnf install jq\n\n# Arch Linux\nsudo pacman -S jq\n```\n\n**Windows:**\n\n### Winget (recommended)\n```powershell\n\n# Winget (recommended)\nwinget install --id=jqlang.jq\n\n# Chocolatey\nchoco install jq\n\n# Scoop\nscoop instal jq\n```\n\n**Verify installation:**\n```bash\njq --version\n# Should output something like: jq-1.6\n```\n\n## API\n\n### Resources\n\n- `file://json`: JSON file operations interface\n\n### Tools\n\n- **query_json**\n  - Execute jq queries on JSON files with complex filters and transformations\n  - Input:\n    - `filePath` (string, optional if default set): Absolute path to JSON file\n    - `query` (string): jq query expression\n  - Example queries:\n    - `\".\"` - Return entire JSON (not recommended)\n    - `\".users\"` - Get users array\n    - `\".users[0].name\"` - Get first user's name\n    - `\".users[] | select(.active == true)\"` - Filter active users\n    - `\".[].price | add\"` - Sum all prices\n\n- **generate_json_schema**\n  - Generate JSON schemas automatically from existing JSON data using genson-js\n  - Input: `filePath` (string, optional if default set): Absolute path to JSON file\n  - Returns: Complete JSON schema that describes the structure of your data\n\n- **validate_json_schema**\n  - Validate that JSON schemas are properly formed using AJV\n  - Input:\n    - `schema` (object): JSON schema object to validate, OR\n    - `schemaFilePath` (string): Path to file containing JSON schema\n  - Returns: Validation result with detailed feedback\n\n## Usage with Claude Desktop\n\nAdd this to your `claude_desktop_config.json`:\n\n### NPX (Recommended)\n\n**Stdio Transport (Default):**\n```json\n{\n  \"mcpServers\": {\n    \"json-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@berrydev-ai/json-mcp-server\",\n        \"--verbose=true\",\n        \"--file-path=/absolute/path/to/your/data.json\"\n      ]\n    }\n  }\n}\n```\n\n**HTTP Transport:**\n```json\n{\n  \"mcpServers\": {\n    \"json-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@berrydev-ai/json-mcp-server\",\n        \"--transport=http\",\n        \"--port=3000\",\n        \"--verbose=true\",\n        \"--file-path=/absolute/path/to/your/data.json\"\n      ]\n    }\n  }\n}\n```\n\n### Local Development\n\n**Stdio Transport:**\n```json\n{\n  \"mcpServers\": {\n    \"json-mcp-server\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"/path/to/json-mcp-server/index.js\",\n        \"--verbose=true\",\n        \"--file-path=/absolute/path/to/your/data.json\"\n      ]\n    }\n  }\n}\n```\n\n**HTTP Transport:**\n```json\n{\n  \"mcpServers\": {\n    \"json-mcp-server\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"/path/to/json-mcp-server/index.js\",\n        \"--transport=http\",\n        \"--port=3000\",\n        \"--host=localhost\",\n        \"--verbose=true\",\n        \"--file-path=/absolute/path/to/your/data.json\"\n      ]\n    }\n  }\n}\n```\n\n### With S3 Sync (Optional)\n\n```json\n{\n  \"mcpServers\": {\n    \"json-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@berrydev-ai/json-mcp-server\",\n        \"--s3-uri=s3://your-bucket/data.json\",\n        \"--file-path=/absolute/path/to/local-data.json\",\n        \"--aws-region=us-east-1\",\n        \"--verbose=true\"\n      ],\n      \"env\": {\n        \"AWS_ACCESS_KEY_ID\": \"your-access-key-id\",\n        \"AWS_SECRET_ACCESS_KEY\": \"your-secret-access-key\"\n      }\n    }\n  }\n}\n```\n\n## Command Line Usage\n\n**Start server locally (stdio transport - default):**\n```bash\nnpm start                    # Basic start with stdio transport\nnpm run dev                  # Start with verbose logging and stdio transport\nnode index.js --verbose=true --file-path=/absolute/path/to/data.json\n```\n\n**Start server with HTTP transport:**\n```bash\nnpm run start:http           # Start HTTP server with verbose logging\nnpm run dev:http             # Start HTTP server on port 3000 with verbose logging\nnode index.js --transport=http --verbose=true --port=3000 --host=localhost\n```\n\n**Transport options:**\n```bash\n--transport=stdio            # Default: stdin/stdout communication\n--transport=http             # HTTP server with session management\n--port=3000                  # HTTP server port (default: 3000)\n--host=localhost             # HTTP server host (default: localhost)\n--cors-origin=*              # CORS allowed origins (default: *)\n```\n\n**Testing:**\n```bash\nnpm test                     # Run test setup (creates test files and validates jq)\nnode test.js                 # Same as above\n```\n\n**MCP Inspector (for debugging):**\n```bash\nnpm run inspect:local       # Test local development version\nnpm run inspect:published   # Test published npm package\n```\n\n## Build\n\n**NPM Installation:**\n```bash\nnpm install -g @berrydev-ai/json-mcp-server\n```\n\n**Local Development:**\n```bash\ngit clone https://github.com/berrydev-ai/json-mcp-server.git\ncd json-mcp-server\nnpm install\n```\n\n## Dependencies\n\n- `@modelcontextprotocol/sdk`: MCP protocol implementation\n- `node-jq`: Node.js wrapper for jq binary (requires system jq installation)\n- `genson-js`: JSON schema generation\n- `ajv`: JSON schema validation\n- `commander`: Command line argument parsing\n- `which`: Binary path detection utility\n- `@aws-sdk/client-s3`: AWS S3 client for optional file synchronization\n- `express`: HTTP server framework for HTTP transport\n- `cors`: Cross-origin resource sharing middleware\n\n## Example JSON Data\n\nCreate a test file `test-data.json`:\n\n```json\n{\n  \"users\": [\n    {\n      \"id\": 1,\n      \"name\": \"John Doe\",\n      \"email\": \"john@example.com\",\n      \"active\": true,\n      \"roles\": [\"user\", \"admin\"]\n    },\n    {\n      \"id\": 2,\n      \"name\": \"Jane Smith\",\n      \"email\": \"jane@example.com\",\n      \"active\": false,\n      \"roles\": [\"user\"]\n    }\n  ],\n  \"metadata\": {\n    \"version\": \"1.0\",\n    \"created_at\": \"2024-01-01T00:00:00Z\"\n  }\n}\n```\n\n## License\n\nThis MCP server is licensed under the ISC License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the ISC License. For more details, please see the LICENSE file in the project repository.\n","readmeFilename":"README.md"}