jsony-mcp
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., "@jsony-mcp Add a new note to notes.json: {'content': 'Meeting at 3pm'}"
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.
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-mcpOption 2: Local Development
git clone https://github.com/vcosmin2701/jsony-mcp
cd mcp-json-server
npm install
npm run buildConfiguration
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.jsonquery_json_objects
Search for objects by property:
Find all completed tasks in todos.jsonupdate_json_object
Update an object at a specific index:
Update index 0 in todos.json: set completed to truedelete_json_object
Remove an object by index:
Delete item at index 2 from todos.jsonlist_json_files
List all available JSON files:
Show me all JSON filesArchitecture
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 buildRun in Development
npm run devTest Locally
npm startContributing
Fork the repository
Create a feature branch
Commit your changes
Push to the branch
Create a Pull Request
License
MIT
Author
Vladut Cosmin
Links
Available Tools
6 toolsadd_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
Scored across 6 tools
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).
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).
Six tools is well-scoped for a JSON file management server, covering essential CRUD operations plus query and file listing without unnecessary bloat.
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
Related MCP Connectors
Zero-key temporary JSON database for agents: one tool call, no signup, no OAuth, no API keys.
Store, query, and update structured data from any AI agent
Files and tables your AI reads and writes from any chat, with version history and sharing.
Create AgentUI data apps: define tables, read and write records, and run programs on your data.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables 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.-
- -licenseCqualityNot gradedmaintenanceEnables 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).3179 npm-
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to store and retrieve information persistently using key-value pairs with JSON file-based storage. Supports storing, retrieving, listing, deleting, and searching data across sessions.-
- AlicenseBqualityBmaintenanceEnables natural language interaction with JSON files, providing tools to load, query, aggregate, transform, and export data directly from AI editors.2684 PyPI3MIT