JSON MCP 服务器 (@gongrzhe/server-json-mcp@1.0.3)

这是一个用于查询和操作 JSON 数据的 JSON 模型上下文协议（MCP）服务器实现。该服务器通过一套标准化工具使大语言模型能够与 JSON 数据进行交互。

安装与使用

# 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

组件

工具

• query

  • 使用带有扩展操作的 JSONPath 语法查询 JSON 数据
  • 输入：
    • url (字符串): JSON 数据源的 URL
    • jsonPath (字符串): 带有可选操作的 JSONPath 表达式

• filter

  • 使用条件过滤 JSON 数据
  • 输入：
    • url (字符串): JSON 数据源的 URL
    • jsonPath (字符串): 基础 JSONPath 表达式
    • condition (字符串): 过滤条件

支持的操作

数组操作

• 切片: $[0:5], $[-3:], $[1:4]
• 排序: $.sort(price), $.sort(-price)
• 去重: $.distinct()
• 转换:
  • 映射: $.map(fieldName)
  • 展平: $.flatten()
  • 并集: $.union([1,2,3])
  • 交集: $.intersection([1,2,3])

字符串操作

• 大小写: $.toLowerCase(), $.toUpperCase()
• 测试: $.startsWith('test'), $.endsWith('test')
• 搜索: $.contains('test'), $.matches('pattern')

数值操作

• 数学运算: $.math(+10), $.pow2()
• 取整: $.round(), $.floor(), $.ceil()
• 函数: $.abs(), $.sqrt()

日期操作

• 格式化: $.format('YYYY-MM-DD')
• 检查: $.isToday()
• 修改: $.add(1, 'days')

聚合操作

• 分组: $.groupBy(category)
• 统计: $.sum(price), $.avg(price), $.min(price), $.max(price)

配置

与 Claude Desktop 一起使用

要在 Claude Desktop 应用中使用此服务器，请在您的 claude_desktop_config.json 中添加以下配置：

{

  "json": {

    "command": "npx",

    "args": [

      "@gongrzhe/server-json-mcp@1.0.3"

    ]

  }

}

或者，如果您已安装了该包，可以直接使用 node 命令：

{

  "json": {

    "command": "node",

    "args": [

      "path/to/build/index.js"

    ]

  }

}

开发

从源代码构建

1. 克隆仓库
2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

注意事项

1. 所有 JSONPath 表达式都以 $ 开头，表示根对象
2. 数组索引是从零开始的
3. 操作中的字符串值应使用引号括起来
4. 日期操作支持 'days', 'months' 和 'years' 单位
5. 数值操作支持基本算术运算符 (+, -, *, /)

许可证

MIT