项目简介

这是一个基于Model Context Protocol (MCP) 构建的服务器,专门设计用于增强大型语言模型 (LLM) 与 JSON 文件的交互能力。它通过标准化的MCP工具机制,允许LLM对JSON数据执行特定的操作,例如分割和合并。

主要功能点

  • JSON 文件分割: 能够将一个大型 JSON 对象按照指定的顶层对象数量分割成多个较小的 JSON 文件或片段。
  • LLM 工具化接口: 将JSON处理能力封装为可供遵循MCP协议的LLM客户端调用的工具。
  • 轻量与快速: 设计目标是提供一个高效、响应迅速的JSON处理服务。

(注:仓库描述提及合并功能,但目前代码实现主要展示了分割工具。)

安装步骤

要使用此MCP服务器,您需要在运行MCP客户端(如某些支持MCP的IDE插件或应用程序)的同一台机器上安装它。推荐使用 'npx' 直接运行最新版本,也可以全局安装:

  • 使用 npx (推荐): 无需安装,直接运行: 'npx json-mcp-server@latest'

  • 全局安装: 通过 npm 全局安装服务器: 'npm install -g json-mcp-server@latest' 安装后,可以通过命令行启动: 'json-mcp-server'

服务器配置

MCP客户端(如VS Code中的GitHub Copilot Agent)需要知道如何启动并连接到这个MCP服务器。典型的配置信息需要指定服务器的名称、启动命令及其参数。

  • 服务器名称: 'json-mcp-server' (客户端用此名称引用服务器)
  • 启动命令 (command): 指定如何执行服务器程序。如果使用'npx',命令通常是 'npx'。如果全局安装,命令是 'json-mcp-server'。
  • 命令参数 (args): 提供给启动命令的额外参数。对于'npx'方式,参数通常是 '["json-mcp-server@latest"]'。对于全局安装方式,参数列表通常为空 '[]'。

您需要在您的MCP客户端配置中填入类似以上的信息,以便客户端能够找到并启动这个MCP服务器。具体的配置方式取决于您使用的MCP客户端应用程序。

基本使用方法

一旦MCP服务器在后台运行并通过您的MCP客户端配置连接成功,兼容的LLM客户端(例如AI Agent)将能够发现服务器提供的工具(如 'split' 工具)。

当LLM需要处理JSON文件时,它可以调用这个服务器上的 'split' 工具。调用时,LLM需要提供JSON文件的内容(作为字符串)以及希望分割成的对象数量作为工具的输入参数。

服务器接收到请求后,会执行分割逻辑,并将分割后的JSON片段作为输出返回给LLM,通常以文件对象的形式呈现,LLM或客户端可以进一步处理这些分割后的内容。

信息

分类

数据库与文件