JSON 模型上下文协议 (MCP) 服务器 (@gongrzhe/server-json-mcp@1.0.3)

一个用于查询和操作 JSON 数据的 JSON Model Context Protocol (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')
• 检查:
  • 是否为今天: $.isToday()
• 修改: $.add(1, 'days')

聚合操作

• 分组: $.groupBy(category)
• 统计:
  • 求和: $.sum(price)
  • 平均值: $.avg(price)
  • 最小值: $.min(price)
  • 最大值: $.max(price)

配置

与 Claude Desktop 使用

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

{
  "config": {
    "@gongrzhe/server-json-mcp@1.0.3": {
      // 配置选项
    }
  }
}

开发

要从源代码构建，请执行以下步骤:

1. 克隆仓库:

   git clone https://github.com/your-username/your-repository.git
   cd your-repository
   

2. 安装依赖:

   npm install
   

3. 构建项目:

   npm run build
   

注意事项

• 请确保安装正确版本的依赖。
• 在生产环境中使用前，请进行全面测试。