Fetch Jsonpath Mcp

by ackness

359 downloads
Not rated
GitHub

About

A Model Context Protocol (MCP) server that provides tools for fetching and extracting JSON data from URLs using JSONPath patterns.

Details

Author
ackness
Downloads
359
Categories
Automation

- Extract JSON data using JSONPath patterns.
- Support for all HTTP methods (GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS).
- Intelligent text extraction with Markdown, clean text, or raw HTML output.
- Batch processing of multiple URLs concurrently.
- Smart browser headers to prevent blocking.
- Reduced token usage and hallucinations.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Fetch Jsonpath Mcp
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install in any MCP-compatible IDE by adding the server configuration with command uvx and args ["fetch-jsonpath-mcp"]. For Claude Code, run claude mcp add fetch-jsonpath-mcp -- uvx fetch-jsonpath-mcp. Tools include fetch-json, fetch-text, batch-fetch-json, and batch-fetch-text. Customize behavior via environment variables such as JSONRPC_MCP_TIMEOUT, JSONRPC_MCP_VERIFY, JSONRPC_MCP_HEADERS, and JSONRPC_MCP_PROXY.

fetch-json

Extract JSON content from a URL using JSONPath with extended features. Supports extensions like len, keys, filtering, arithmetic operations, and more. If 'pattern' is omitted or empty, the entire JSON document is returned. Supports different HTTP methods (default: GET).

fetch-text

Fetch text content from a URL using various HTTP methods. Defaults to converting HTML to Markdown format.

batch-fetch-json

Batch extract JSON content from multiple URLs with different extended JSONPath patterns. Supports all JSONPath extensions and optimizes by fetching each unique request only once. Executes requests concurrently for better performance. Supports different HTTP methods.

batch-fetch-text

Batch fetch raw text content from multiple URLs using various HTTP methods. Executes requests concurrently for better performance.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "fetch jsonpath mcp": {
            "fetch-jsonpath-mcp": {
                "command": "uvx",
                "args": [
                    "fetch-jsonpath-mcp"
                ]
            }
        }
    }
}

McpServers

{
    "fetch-jsonpath-mcp": {
        "command": "uvx",
        "args": [
            "fetch-jsonpath-mcp"
        ]
    }
}

Fetch JSONPath MCP

PyPI Downloads 简体中文 A Model Context Protocol (MCP) server that provides tools for fetching JSON data and web content from URLs. Features intelligent content extraction, multiple HTTP methods, and browser-like headers for reliable web scraping.

🎯 Why Use This?

Reduce LLM Token Usage & Hallucination - Instead of fetching entire JSON responses and wasting tokens, extract only the data you need.

Traditional Fetch vs JSONPath Extract

❌ Traditional fetch (wasteful): ``json // API returns 2000+ tokens { "data": [ { "id": 1, "name": "Alice", "email": "alice@example.com", "avatar": "https://...", "profile": { "bio": "Long bio text...", "settings": {...}, "preferences": {...}, "metadata": {...} }, "posts": [...], "followers": [...], "created_at": "2023-01-01", "updated_at": "2024-01-01" }, // ... 50 more users ], "pagination": {...}, "meta": {...} } ` ✅ JSONPath extract (efficient): `json // Only 10 tokens - exactly what you need! ["Alice", "Bob", "Charlie"] ` Using pattern: data[*].name saves 99% tokens and eliminates model hallucination from irrelevant data.

Installation

For most IDEs, use the
uvx tool to run the server. `json { "mcpServers": { "fetch-jsonpath-mcp": { "command": "uvx", "args": [ "fetch-jsonpath-mcp" ] } } } ` <details> <summary><b>Install in Claude Code</b></summary> `bash claude mcp add fetch-jsonpath-mcp -- uvx fetch-jsonpath-mcp ` </details> <details> <summary><b>Install in Cursor</b></summary> `json { "mcpServers": { "fetch-jsonpath-mcp": { "command": "uvx", "args": ["fetch-jsonpath-mcp"] } } } ` </details> <details> <summary><b>Install in Windsurf</b></summary> Add this to your Windsurf MCP config file. See Windsurf MCP docs for more info.

Windsurf Local Server Connection

`json { "mcpServers": { "fetch-jsonpath-mcp": { "command": "uvx", "args": ["fetch-jsonpath-mcp"] } } } ` </details> <details> <summary><b>Install in VS Code</b></summary> `json "mcp": { "servers": { "fetch-jsonpath-mcp": { "type": "stdio", "command": "uvx", "args": ["fetch-jsonpath-mcp"] } } } ` </details>

Development Setup

1. Install Dependencies

`bash uv sync `

2. Start Demo Server (Optional)

``bash
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.