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

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

安装与使用

# 使用 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 (字符串): 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')
• 时间差: $.diff()

聚合操作

• 求和: $.sum()
• 平均值: $.avg()
• 最大值: $.max()
• 最小值: $.min()

配置

要配置此服务器以与 Claude Desktop 一起使用，请将以下内容添加到 claudius.config.js 文件中：

module.exports = {
  mcp: {
    server: 'http://localhost:3000'
  }
}

如果您未全局安装包，而是直接通过 Node.js 运行服务器，请确保提供完整的路径。

开发

要在开发环境中运行此服务器，请执行以下命令：

npm run dev

然后您可以通过访问 http://localhost:3000 使用服务器。