JSON Manipulation

🚀 JSON Model Context Protocol (MCP) Server (@gongrzhe/server-json-mcp@1.0.3)

A JSON Model Context Protocol (MCP) server implementation for querying and manipulating JSON data. This server allows Large Language Models (LLMs) to interact with JSON data through a set of standardized tools.

🚀 Quick Start

📦 Installation

# Use npx with a specific version (recommended)
npx @gongrzhe/server-json-mcp@1.0.3

# Install a specific version globally
npm install -g @gongrzhe/server-json-mcp@1.0.3

# Run after global installation
server-json-mcp

✨ Features

🛠️ Tools

• query

  • Query JSON data using JSONPath syntax, supporting extended operations.
  • Input:
    • url (string): The URL of the JSON data source.
    • jsonPath (string): A JSONPath expression with optional operations.

• filter

  • Filter JSON data based on conditions.
  • Input:
    • url (string): The URL of the JSON data source.
    • jsonPath (string): A basic JSONPath expression.
    • condition (string): The filtering condition.

🎛️ Supported Operations

Array Operations

• Slicing: $[0:5], $[-3:], $[1:4]
• Sorting: $.sort(price), $.sort(-price)
• Deduplication: $.distinct()
• Transformation:
  • Mapping: $.map(fieldName)
  • Flattening: $.flatten()
  • Union: $.union([1,2,3])
  • Intersection: $.intersection([1,2,3])

String Operations

• Case Conversion: $.toLowerCase(), $.toUpperCase()
• Testing:
  • Starts with...: $.startsWith('test')
  • Ends with...: $.endsWith('test')
  • Contains: $.contains('test')
  • Regular expression matching: $.matches('pattern')

Numeric Operations

• Mathematical Operations: $.math(+10), $.pow2()
• Rounding:
  • $.round()
  • $.floor()
  • $.ceil()
• Functions:
  • Absolute value: $.abs()
  • Square root: $.sqrt()

Date Operations

• Formatting: $.format('YYYY-MM-DD')
• Checking:
  • Is today: $.isToday()
• Modification: $.add(1, 'days')

Aggregation Operations

• Grouping: $.groupBy(category)
• Statistics:
  • Summation: $.sum(price)
  • Average: $.avg(price)
  • Minimum: $.min(price)
  • Maximum: $.max(price)

📚 Documentation

🖥️ Using with Claude Desktop

To use this server in the Claude Desktop application, add the following configuration to your claude_desktop_config.json file:

{
  "config": {
    "@gongrzhe/server-json-mcp@1.0.3": {
      // Configuration options
    }
  }
}

💻 Development

To build from source, follow these steps:

1. Clone the repository:

   git clone https://github.com/your-username/your-repository.git
   cd your-repository
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

⚠️ Important Note

• Ensure that you install the correct version of the dependencies.
• Conduct comprehensive testing before using in a production environment.