Servidor JSON MCP (@gongrzhe/server-json-mcp@1.0.3)

Implementación de un servidor del Protocolo de Contexto de Modelo (MCP) JSON para consultar y manipular datos JSON. Este servidor permite a los LLM interactuar con datos JSON mediante un conjunto de herramientas estandarizadas.

Instalación y uso

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

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

# Run after global installation
server-json-mcp

Related MCP server: MCP Database Server

Componentes

Herramientas

• consulta

  • Consultar datos JSON utilizando la sintaxis JSONPath con operaciones extendidas

  • Aporte:

    • url (cadena): URL de la fuente de datos JSON

    • jsonPath (cadena): expresión JSONPath con operaciones opcionales

• filtrar

  • Filtrar datos JSON mediante condiciones

  • Aporte:

    • url (cadena): URL de la fuente de datos JSON

    • jsonPath (cadena): expresión base JSONPath

    • condition (cadena): condición de filtro

Operaciones apoyadas

Operaciones de matriz

• Corte : $[0:5] , $[-3:] , $[1:4]

• Ordenación : $.sort(price) , $.sort(-price)

• Distinto : $.distinct()

• Transformaciones :

  • Mapa: $.map(fieldName)

  • Aplanar: $.flatten()

  • Unión: $.union([1,2,3])

  • Intersección: $.intersection([1,2,3])

Operaciones con cadenas

• Caso : $.toLowerCase() , $.toUpperCase()

• Pruebas : $.startsWith('test') , $.endsWith('test')

• Buscar : $.contains('test') , $.matches('pattern')

Operaciones numéricas

• Matemáticas : $.math(+10) , $.pow2()

• Redondeo : $.round() , $.floor() , $.ceil()

• Funciones : $.abs() , $.sqrt()

Operaciones de fecha

• Formato : $.format('YYYY-MM-DD')

• Comprobar : $.isToday()

• Modificar : $.add(1, 'days')

Operaciones de agregación

• Grupo : $.groupBy(category)

• Estadísticas : $.sum(price) , $.avg(price) , $.min(price) , $.max(price)

Configuración

Uso con Claude Desktop

Para utilizar este servidor con la aplicación Claude Desktop, agregue la siguiente configuración a su claude_desktop_config.json :

{
  "json": {
    "command": "npx",
    "args": [
      "@gongrzhe/server-json-mcp@1.0.3"
    ]
  }
}

Alternativamente, puede utilizar el comando node directamente si tiene el paquete instalado:

{
  "json": {
    "command": "node",
    "args": [
      "path/to/build/index.js"
    ]
  }
}

Desarrollo

Construyendo desde la fuente

1. Clonar el repositorio

2. Instalar dependencias:

   npm install

3. Construir el proyecto:

   npm run build

Notas

1. Todas las expresiones JSONPath comienzan con $ que representa el objeto raíz

2. Los índices de matriz se basan en cero

3. Los valores de cadena en las operaciones deben estar entre comillas

4. Las operaciones de fecha admiten unidades de "días", "meses" y "años".

5. Las operaciones numéricas admiten operadores aritméticos básicos (+, -, *, /)

Licencia

Instituto Tecnológico de Massachusetts (MIT)