JSON-MCP-Server

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

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

🚀 快速开始

JSON MCP 服务器可帮助大型语言模型方便地与 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 使用服务器。