JSON Manipulation

🚀 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
   

⚠️ 重要提示

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