AI导哈

JSON数据查询与操作服务器

一个用于查询和操作JSON数据的服务器实现，通过标准化工具使LLM能够与JSON数据交互。

  • by GongRzhe
  • JavaScript
  • 本地部署
  • 90 星标
  • 更新于
在 GitHub 查看 GongRzhe/JSON-MCP-Server

使用说明

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

用于查询和操作JSON数据的JSON模型上下文协议（MCP）服务器实现。此服务器使LLM能够通过一组标准化的工具与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

组件

工具

  • 怎么翻译

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

  • 过滤器

    • 使用条件过滤JSON数据
    • 输入：
      • url （string）：JSON数据源的URL
      • jsonPath （string）：基本JSONPath表达式
      • condition （string）：筛选条件

支持的操作

阵列操作

  • 切片: $[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. 日期操作支持“天”、“月”和“年”单位
  5. 数字运算支持基本算术运算符（+、-、*、/）

许可证

麻省理工学院

相关 MCP