Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@JSON MCP Server set name to John Doe in data.json"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A powerful MCP (Model Context Protocol) server for editing and managing JSON files with dot-notation path access.
✅ 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: Store MCP Server
# Activate virtual environment
source venv/bin/activate
# Install dependencies
pip install -r requirements.txtpython mcp_json.pyThe server runs on stdio transport by default, which is the standard for MCP clients like Claude Desktop.
json:get - Get ValueRetrieve 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")json:set - Set ValueSet 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")json:delete - Delete KeyDelete 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")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"
}
}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")json:set(path="tasks.json", key="tasks", value='[{"id":1,"title":"Learn MCP","done":false}]')
json:get(path="tasks.json", key="tasks.0.title")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
}
}
}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
❌ 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
The server uses FastMCP, which provides:
Automatic parameter validation
Built-in error handling
Support for multiple transports (stdio, SSE, HTTP)
MIT
This server cannot be deployed
Compare two JSON files deeply, regardless of order. Get a detailed difference report highlighting…
Zero-key temporary JSON database for agents: one tool call, no signup, no OAuth, no API keys.
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.
