JSON MCP Server 使用说明

项目简介

JSON MCP Server 是一个实现了 Model Context Protocol 协议的服务器，专注于处理 JSON 数据。它提供了一系列工具，使 LLM 客户端能够通过标准化的方式查询、过滤和操作远程 JSON 数据。

主要功能点

• JSON 数据查询: 使用扩展的 JSONPath 语法，可以灵活地从 URL 获取的 JSON 数据中提取所需信息。
• JSON 数据过滤: 支持基于条件的 JSON 数据过滤，可以根据字段值筛选 JSON 数据。
• 丰富的操作: 内置了多种 JSON 数据操作，包括数组切片、排序、去重、聚合计算、字符串处理、日期处理等。

安装步骤

1. 确保已安装 Node.js 和 npm。
2. 使用 npm 或 npx 安装 'server-json-mcp' 包。推荐使用 npx 运行，无需全局安装：

   npx @gongrzhe/[email protected]
   

   或者全局安装：

   npm install -g @gongrzhe/[email protected]
   

3. 如果全局安装，可以直接运行 'server-json-mcp' 命令启动服务器。

服务器配置

对于 MCP 客户端，例如 Claude Desktop，你需要配置启动 JSON MCP Server 的命令。以下是一个配置示例，请根据你的实际安装方式选择：

使用 npx (推荐):

{
  "json": {
    "command": "npx",
    "args": [
      "@gongrzhe/[email protected]"
    ]
  }
}

• 'command': 设置为 'npx'，用于执行 npm 包。
• 'args': 设置为 '["@gongrzhe/[email protected]"]'，指定要执行的 npm 包及其版本。

全局安装后使用 node 命令: 如果已全局安装 'server-json-mcp'，并且知道 'build/index.js' 文件的路径，可以使用 'node' 命令启动：

{
  "json": {
    "command": "node",
    "args": [
      "path/to/build/index.js"  // 请替换为实际的 index.js 文件路径
    ]
  }
}

• 'command': 设置为 'node'，用于执行 Node.js 程序。
• 'args': 设置为 '["path/to/build/index.js"]'，指定 'index.js' 文件的路径。你需要将 '"path/to/build/index.js"' 替换为服务器 'build/index.js' 文件的实际绝对路径。

基本使用方法

1. 启动 JSON MCP Server。
2. 在 MCP 客户端中配置并连接到该服务器。
3. 使用客户端提供的界面或方式，调用 'query' 或 'filter' 工具，并提供相应的参数（例如 JSON 数据 URL 和 JSONPath 表达式）来查询或过滤数据。服务器会将处理结果返回给客户端。