Skip to main content
Glama

JSON MCP Server

by berrydev-ai
npmGitHub
JavaScript
9
  • Apple
  • Linux
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

JSON MCP Server

Node.js server implementing Model Context Protocol (MCP) for JSON operations.

Features

  • Query JSON files using jq notation with complex filters and transformations

  • Generate JSON schemas automatically from existing JSON data

  • Validate JSON schemas to ensure they are properly formed

  • S3 sync support for remote JSON file synchronization

  • Support for both stdio and HTTP transport protocols

Note: The server requires jq binary to be installed on your system and will only allow operations on files with absolute paths.

Prerequisites

🚨 Required: Install jq binary on your system

macOS:

brew install jq

Linux:

# Ubuntu/Debian sudo apt-get install jq # CentOS/RHEL/Fedora sudo yum install jq # or sudo dnf install jq # Arch Linux sudo pacman -S jq

Windows:

Winget (recommended)

# Winget (recommended) winget install --id=jqlang.jq # Chocolatey choco install jq # Scoop scoop instal jq

Verify installation:

jq --version # Should output something like: jq-1.6

API

Resources

  • file://json: JSON file operations interface

Tools

  • query_json

    • Execute jq queries on JSON files with complex filters and transformations

    • Input:

      • filePath (string, optional if default set): Absolute path to JSON file

      • query (string): jq query expression

    • Example queries:

      • "." - Return entire JSON (not recommended)

      • ".users" - Get users array

      • ".users[0].name" - Get first user's name

      • ".users[] | select(.active == true)" - Filter active users

      • ".[].price | add" - Sum all prices

  • generate_json_schema

    • Generate JSON schemas automatically from existing JSON data using genson-js

    • Input: filePath (string, optional if default set): Absolute path to JSON file

    • Returns: Complete JSON schema that describes the structure of your data

  • validate_json_schema

    • Validate that JSON schemas are properly formed using AJV

    • Input:

      • schema (object): JSON schema object to validate, OR

      • schemaFilePath (string): Path to file containing JSON schema

    • Returns: Validation result with detailed feedback

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

NPX (Recommended)

Stdio Transport (Default):

{ "mcpServers": { "json-mcp-server": { "command": "npx", "args": [ "-y", "@berrydev-ai/json-mcp-server", "--verbose=true", "--file-path=/absolute/path/to/your/data.json" ] } } }

HTTP Transport:

{ "mcpServers": { "json-mcp-server": { "command": "npx", "args": [ "-y", "@berrydev-ai/json-mcp-server", "--transport=http", "--port=3000", "--verbose=true", "--file-path=/absolute/path/to/your/data.json" ] } } }

Local Development

Stdio Transport:

{ "mcpServers": { "json-mcp-server": { "command": "node", "args": [ "/path/to/json-mcp-server/index.js", "--verbose=true", "--file-path=/absolute/path/to/your/data.json" ] } } }

HTTP Transport:

{ "mcpServers": { "json-mcp-server": { "command": "node", "args": [ "/path/to/json-mcp-server/index.js", "--transport=http", "--port=3000", "--host=localhost", "--verbose=true", "--file-path=/absolute/path/to/your/data.json" ] } } }

With S3 Sync (Optional)

{ "mcpServers": { "json-mcp-server": { "command": "npx", "args": [ "-y", "@berrydev-ai/json-mcp-server", "--s3-uri=s3://your-bucket/data.json", "--file-path=/absolute/path/to/local-data.json", "--aws-region=us-east-1", "--verbose=true" ], "env": { "AWS_ACCESS_KEY_ID": "your-access-key-id", "AWS_SECRET_ACCESS_KEY": "your-secret-access-key" } } } }

Command Line Usage

Start server locally (stdio transport - default):

npm start # Basic start with stdio transport npm run dev # Start with verbose logging and stdio transport node index.js --verbose=true --file-path=/absolute/path/to/data.json

Start server with HTTP transport:

npm run start:http # Start HTTP server with verbose logging npm run dev:http # Start HTTP server on port 3000 with verbose logging node index.js --transport=http --verbose=true --port=3000 --host=localhost

Transport options:

--transport=stdio # Default: stdin/stdout communication --transport=http # HTTP server with session management --port=3000 # HTTP server port (default: 3000) --host=localhost # HTTP server host (default: localhost) --cors-origin=* # CORS allowed origins (default: *)

Testing:

npm test # Run test setup (creates test files and validates jq) node test.js # Same as above

MCP Inspector (for debugging):

npm run inspect:local # Test local development version npm run inspect:published # Test published npm package

Build

NPM Installation:

npm install -g @berrydev-ai/json-mcp-server

Local Development:

git clone https://github.com/berrydev-ai/json-mcp-server.git cd json-mcp-server npm install

Dependencies

  • @modelcontextprotocol/sdk: MCP protocol implementation

  • node-jq: Node.js wrapper for jq binary (requires system jq installation)

  • genson-js: JSON schema generation

  • ajv: JSON schema validation

  • commander: Command line argument parsing

  • which: Binary path detection utility

  • @aws-sdk/client-s3: AWS S3 client for optional file synchronization

  • express: HTTP server framework for HTTP transport

  • cors: Cross-origin resource sharing middleware

Example JSON Data

Create a test file test-data.json:

{ "users": [ { "id": 1, "name": "John Doe", "email": "john@example.com", "active": true, "roles": ["user", "admin"] }, { "id": 2, "name": "Jane Smith", "email": "jane@example.com", "active": false, "roles": ["user"] } ], "metadata": { "version": "1.0", "created_at": "2024-01-01T00:00:00Z" } }

License

This 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.

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Provides powerful JSON manipulation tools through Model Context Protocol, enabling complex queries, schema generation, and validation with jq notation and native Node.js operations.

  1. Features
    1. Prerequisites
      1. Winget (recommended)
    2. API
      1. Resources
      2. Tools
    3. Usage with Claude Desktop
      1. NPX (Recommended)
      2. Local Development
      3. With S3 Sync (Optional)
    4. Command Line Usage
      1. Build
        1. Dependencies
          1. Example JSON Data
            1. License

              Related MCP Servers

              • Node Omnibus MCP Server

                bsmi021
                A
                security
                A
                license
                A
                quality
                A comprehensive Model Context Protocol server that provides advanced Node.js development tooling for automating project creation, component generation, package management, and documentation with AI-powered assistance.
                Last updated -
                7
                5
                MIT License

              • JSON MCP Server

                GongRzhe
                A
                security
                A
                license
                A
                quality
                A Model Context Protocol server implementation that enables LLMs to query and manipulate JSON data using JSONPath syntax with extended operations for filtering, sorting, transforming, and aggregating data.
                Last updated -
                2
                80
                78
                MIT License
                • Apple
                • Linux

              • Custom Context MCP Server

                omer-ayhan
                A
                security
                A
                license
                A
                quality
                A Model Context Protocol server that transforms text into structured JSON data using templates with placeholders.
                Last updated -
                2
                1
                MIT License

              • JSON Query MCP

                mgraczyk
                A
                security
                F
                license
                A
                quality
                A Model Context Protocol server for querying large JSON files using JSONPath expressions, enabling LLMs to efficiently search and extract information from large JSON data.
                Last updated -
                3
                7

              View all related MCP servers

              Appeared in Searches

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/berrydev-ai/json-mcp-server'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server