jq-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., "@jq-mcp extract names from users.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.
jq-mcp
An MCP server that exposes a single tool, jq, for running jq filters against JSON files on disk.
Use
Add to your MCP client config:
{
"mcpServers": {
"jq-mcp": {
"command": "npx",
"args": ["jq-mcp@latest"]
}
}
}The jq tool takes file and query and returns the stdout of jq <query> <file>. By default it can read files under the server's working directory and /tmp.
Related MCP server: mcp-json-reader
Advanced: custom allowlist
Set ALLOWED_PATHS (comma-separated directories) in the server's env to override the default <cwd>,/tmp:
"env": { "ALLOWED_PATHS": "/path/to/allow,/another/path" }Path matching normalizes the input before comparing, so:
..segments cannot escape an allowed directory.Sibling directories that share a string prefix (e.g.
/foo/bar-evilvs/foo/bar) are rejected — the check is path-boundary aware, not a naivestartsWith.
Develop
npm test # node:test suite
npm run buildAvailable Tools
1 tooljqA
Runs a jq query against a JSON file, gated by an allowlist of directories.
Inputs: file (required), query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or overlap between tools. The single tool has a clear, singular purpose.
The sole tool is named 'jq', which is concise and directly reflects its function. While it does not follow a verb_noun pattern, there is no inconsistency since there is only one tool.
A single tool for running jq queries is slightly below the typical 3-15 range, but it is reasonable for a focused utility that performs one specific operation.
The server provides the core jq query functionality, but lacks supporting tools such as listing available files or directories, which may cause agent failures when needing to discover inputs.
Maintenance
Related MCP Connectors
An MCP server that provides bazaarvoic JOLT transformation capabilities.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Related MCP Servers
- AlicenseAqualityBmaintenanceLocal MCP server that registers restricted Python filters and runs them against local JSON, YAML, and TXT files, enabling safe data filtering and file conversion.36MIT
- AlicenseNot gradedqualityBmaintenanceMCP server for reading, querying, and filtering local JSON files with extended JSONPath syntax, supporting sorting, aggregations, and complex conditions.19 npm2MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that provides tools to read JSON files and query data using jsonPath expressions.-
- AlicenseNot gradedqualityDmaintenanceA minimal, zero-dependency MCP server that enables defining and running tools over stdio transport, without extra features like HTTP or resources.26 npm1MIT