Skip to main content
Glama
onehumanbeing

JSON MCP Server

JSON MCP Server

A powerful MCP (Model Context Protocol) server for editing and managing JSON files with dot-notation path access.

Features

  • ✅ Read JSON values using dot-separated paths

  • ✏️ Set or update JSON values (supports nested structures)

  • 🗑️ Delete JSON key-value pairs

  • 🔄 Auto-create missing JSON files

  • 🌳 Automatically create intermediate nested objects

Related MCP server: Task Manager

Installation

# Activate virtual environment
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

Running the Server

python mcp_json.py

The server runs on stdio transport by default, which is the standard for MCP clients like Claude Desktop.

Tools

1. json:get - Get Value

Retrieve a value from a JSON file using a dot-separated key path.

Parameters:

  • path: JSON file path (absolute or relative)

  • key: Dot-separated key path (e.g., "user.name")

Examples:

json:get(path="data.json", key="name")
json:get(path="config.json", key="database.host")
json:get(path="users.json", key="users.0.name")

2. json:set - Set Value

Set or update a value in a JSON file. Supports JSON strings or plain strings. Automatically creates missing intermediate objects.

Parameters:

  • path: JSON file path

  • key: Dot-separated key path

  • value: Value to set (can be JSON string)

Examples:

json:set(path="data.json", key="name", value="John Doe")
json:set(path="config.json", key="port", value="3000")
json:set(path="config.json", key="database", value='{"host":"localhost","port":5432}')
json:set(path="data.json", key="tags", value='["python","mcp","json"]')
json:set(path="config.json", key="api.endpoints.users", value="/api/v1/users")

3. json:delete - Delete Key

Delete a key from a JSON file using a dot-separated key path.

Parameters:

  • path: JSON file path

  • key: Dot-separated key path

Examples:

json:delete(path="data.json", key="oldField")
json:delete(path="config.json", key="database.password")
json:delete(path="user.json", key="settings.theme")

Usage Examples

Example 1: Create User Configuration

json:set(path="user.json", key="profile.name", value="John Doe")
json:set(path="user.json", key="profile.email", value="john@example.com")
json:set(path="user.json", key="profile.age", value="30")
json:set(path="user.json", key="settings.theme", value="dark")
json:set(path="user.json", key="settings.notifications", value="true")
json:get(path="user.json", key="profile")

Result user.json:

{
  "profile": {
    "name": "John Doe",
    "email": "john@example.com",
    "age": "30"
  },
  "settings": {
    "theme": "dark",
    "notifications": "true"
  }
}

Example 2: Manage API Configuration

json:set(path="api.json", key="api.baseUrl", value="https://api.example.com")
json:set(path="api.json", key="api.version", value="v2")
json:set(path="api.json", key="api.timeout", value="5000")
json:set(path="api.json", key="endpoints", value='{"users":"/users","posts":"/posts"}')
json:get(path="api.json", key="api")
json:delete(path="api.json", key="endpoints.posts")

Example 3: Working with Arrays

json:set(path="tasks.json", key="tasks", value='[{"id":1,"title":"Learn MCP","done":false}]')
json:get(path="tasks.json", key="tasks.0.title")

MCP Client Configuration

Add this server to your MCP client (e.g., Claude Desktop):

{
  "mcpServers": {
    "json-editor": {
      "command": "python3",
      "args": ["/absolute/path/to/mcp_json.py"],
      "enabled": true
    }
  }
}

Or using the virtual environment Python:

{
  "mcpServers": {
    "json-editor": {
      "command": "/absolute/path/to/venv/bin/python",
      "args": ["/absolute/path/to/mcp_json.py"],
      "enabled": true
    }
  }
}

How It Works

  • Dot-notation paths: Use dots (.) to separate nested keys: "user.profile.name"

  • Auto-creation: Missing files are created as empty objects {}

  • Nested objects: Missing intermediate objects are automatically created

  • Value parsing: The value parameter attempts JSON parsing first, falls back to string

  • Pretty formatting: JSON files are saved with 2-space indentation

Error Messages

  • ❌ Key not found: {key} - When trying to get or delete a non-existent key

  • Invalid JSON format: {path} - When the file exists but contains invalid JSON

Development

The server uses FastMCP, which provides:

  • Automatic parameter validation

  • Built-in error handling

  • Support for multiple transports (stdio, SSE, HTTP)

License

MIT

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    -
    quality
    -
    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.
  • A
    license
    -
    quality
    C
    maintenance
    Enables users to manage tasks through a simple JSON file interface. Provides basic task management functionality by reading and writing to a configurable tasks.json file.
    12
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables efficient JSON file editing with targeted read, write, delete, and deep merge operations using dot notation paths, optimized for managing multilingual projects and large configuration files.
    4
    22
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • Compare two JSON files deeply, regardless of order. Get a detailed difference report highlighting…

  • Read and write your Fresh Jots notes from Claude, Cursor, and any MCP client.

  • Create, validate, edit, export (markdown/svg/png/mermaid), and search JSON Canvas files.

View all MCP Connectors

Latest Blog Posts

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/onehumanbeing/large_json_edit_mcp'

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