Skip to main content
Glama
jsony-mcp

jsony-mcp

by vcosmin2701

MCP JSON Server

A Model Context Protocol (MCP) server that provides tools for managing JSON data files. This server allows AI assistants like Claude to read, write, query, and manage JSON files in a structured way.

Features

  • Add JSON Objects: Add new objects to JSON files with automatic ID and timestamp generation

  • Query Objects: Search for objects by property values

  • Update Objects: Modify existing objects by index

  • Delete Objects: Remove objects from JSON files

  • List Files: View all available JSON files

  • Retrieve Objects: Get all objects from a specific file

Related MCP server: MCP JSON Maker

Installation

Option 1: Install from npm

npm install -g jsony-mcp

Option 2: Local Development

git clone https://github.com/vcosmin2701/jsony-mcp
cd mcp-json-server
npm install
npm run build

Configuration

Claude Desktop Configuration

Add the server to your Claude desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "json-manager": {
      "command": "jsony-mcp"
    }
  }
}

For local development:

{
  "mcpServers": {
    "json-manager": {
      "command": "node",
      "args": ["/path/to/mcp-json-server/dist/server.js"]
    }
  }
}

Data Directory

By default, JSON files are stored in ~/.mcp-json-server/data/

You can customize this location using the MCP_JSON_DATA_DIR environment variable:

{
  "mcpServers": {
    "json-manager": {
      "command": "jsony-mcp",
      "env": {
        "MCP_JSON_DATA_DIR": "/custom/path/to/data"
      }
    }
  }
}

Usage

Once configured, Claude can use the following tools:

add_json_object

Add a new object to a JSON file:

Add to todos.json: {"title": "Buy groceries", "completed": false}

get_json_objects

Retrieve all objects from a file:

Get all items from todos.json

query_json_objects

Search for objects by property:

Find all completed tasks in todos.json

update_json_object

Update an object at a specific index:

Update index 0 in todos.json: set completed to true

delete_json_object

Remove an object by index:

Delete item at index 2 from todos.json

list_json_files

List all available JSON files:

Show me all JSON files

Architecture

The server follows clean code principles and SOLID design patterns:

  • Separation of Concerns: Modular architecture with distinct layers

  • Dependency Injection: Improved testability and maintainability

  • Strategy Pattern: Extensible tool handler system

  • Repository Pattern: Abstracted data access layer

  • Error Handling: Custom error types with proper propagation

See ARCHITECTURE.md for detailed documentation.

Development

Build

npm run build

Run in Development

npm run dev

Test Locally

npm start

Contributing

  1. Fork the repository

  2. Create a feature branch

  3. Commit your changes

  4. Push to the branch

  5. Create a Pull Request

License

MIT

Author

Vladut Cosmin

Available Tools

6 tools
add_json_objectB

Add a JSON object to a specified file

Inputs: object (required), filename (required).

delete_json_objectB

Delete a JSON object by index

Inputs: index (required), filename (required).

get_json_objectsA

Retrieve all objects from a JSON file

Inputs: filename (required).

list_json_filesA

List all available JSON files

Inputs: no named parameters.

query_json_objectsC

Query JSON objects based on property values

Inputs: value (required), filename (required), property (required).

update_json_objectB

Update a JSON object by index

Inputs: index (required), updates (required), filename (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool targets a distinct operation: add, get all, query, update, delete, and list files. There is no overlap in purpose; even get_json_objects and query_json_objects are clearly different (retrieve all vs. filter by properties).

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern: add_json_object, get_json_objects, query_json_objects, update_json_object, delete_json_object, list_json_files. The use of singular/plural is logical (action on single vs. multiple).

    Tool Count5/5

    Six tools is well-scoped for a JSON file management server, covering essential CRUD operations plus query and file listing without unnecessary bloat.

    Completeness4/5

    The core CRUD lifecycle is covered: add, get, update, delete, plus query and list files. A minor gap is the lack of a dedicated get-by-index or file deletion, but these can be worked around with existing tools.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables users to manage data in a simple JSON file database through MCP tools and REST API. Supports creating, reading, updating, and deleting items organized in collections with auto-generated UUIDs.
      -
    • -
      license
      C
      quality
      Not graded
      maintenance
      Enables AI to create, edit, and batch generate JSON data with advanced rule engines. Supports CRUD operations, node-level editing, template management, and multi-format file exports (JSON, JSONL, CSV).
      3
      179 npm
      -