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

一个用于查询和操作 JSON 数据的 JSON 模型上下文协议 (MCP) 服务器实现。该服务器使 LLM 能够通过一组标准化工具与 JSON 数据进行交互。

<a href="https://glama.ai/mcp/servers/9g137c4b4k"> <img width="380" height="200" src="https://glama.ai/mcp/servers/9g137c4b4k/badge" alt="JSON Server MCP server" /> </a>

安装 & 使用

# 使用带有特定版本的 npx (推荐)
npx @gongrzhe/server-json-mcp@1.0.3

# 全局安装特定版本
npm install -g @gongrzhe/server-json-mcp@1.0.3

# 全局安装后运行
server-json-mcp

组件

工具

• query

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

• filter

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

支持的操作

数组操作

• 切片: $[0:5], $[-3:], $[1:4]
• 排序: $.sort(price), $.sort(-price)
• 去重: $.distinct()
• 转换:
  • Map: $.map(fieldName)
  • Flatten: $.flatten()
  • Union: $.union([1,2,3])
  • Intersection: $.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