JSON转Excel工具

JSON to Excel MCP 提供标准化接口,用于将JSON数据转换为CSV格式字符串,支持从数据字符串或URL获取JSON文件进行转换。

  • by he-yang
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 he-yang/json-to-excel-mcp

使用说明

WTSolutions将JSON转换为Excel MCP

中文

简介

这 JSON转换为Excel MCP (模型上下文协议)提供了一个标准化的接口,用于使用模型上下文协议将JSON数据转换为CSV格式字符串。此MCP实现提供了两种特定的数据转换工具:

  • json_to_excel_mcp_from_data:将JSON数据字符串转换为CSV格式。
  • json_to_excel_mcp_from_url:将JSON文件从提供的URL(.JSON格式)转换为CSV格式字符串。

JSON到Excel MCP是WTSolutions的JSON到Excel工具包的一部分:

服务器配置

可用的MCP服务器(SSE和流式HTTP):

使用标准(NPX)

服务器配置JSON:

案例1:免费版本(最多处理6行数据)

如果您使用的是免费版本:

{
  "mcpServers": {
    "json-to-excel-mcp": {
      "args": [
        "json-to-excel-mcp"        
      ],
      "command": "npx"
    }
  }
}

案例2:专业版

如果您使用的是专业版(带有有效的proCode):

{
  "mcpServers": {
    "json-to-excel-mcp": {
      "args": [
        "json-to-excel-mcp"        
      ],
      "command": "npx",
      "env": {
        "proCode": "type in your proCode here"
      }
    }
  }
}

使用SSE

从v0.3.0开始不支持

使用流式HTTP

从v0.3.0开始不支持

MCP工具

json_to_excel_mcp_from_data

将JSON数据字符串转换为CSV格式字符串。

参数

参数 类型 必填 说明
data string Yes 要转换为CSV的JSON数据字符串。必须是有效的JSON数组或对象。
options object No 用于自定义转换过程的可选配置对象。

注:

  • 输入数据必须是有效的JSON字符串。JSON架构可在 JSON模式 验证器可在 JSON到Excel Web应用程序.
  • 如果JSON是一个对象数组,则每个对象都将被视为CSV中的一行。
  • 如果JSON是单个对象,它将被转换为具有键值对的CSV。
  • CSV将包含基于JSON对象中键的标头。
  • 此工具返回CSV格式的数据,可以轻松转换/导入Excel。

选项对象

选项对象可以包含以下属性:

属性 类型 默认值 描述
proCode string “” Pro-Code JSON到Excel服务。
jsonMode string “flat” JSON输出的格式模式:“嵌套”或“flat
delimiter string “.” 使用jsonMode时嵌套JSON键的分隔符:“嵌套”,可接受的分隔符为“.”、“_”、“__”、“/”。
maxDepth string “unlimited” 使用jsonMode时嵌套JSON对象的最大深度:“nested”。对于最大深度,可以接受“无限”、“1”~“20”。

注:

  • 如果您没有有效的 专业代码,最多处理6行。
  • 详细的转换规则可以在 特性.

示例提示1:

将以下JSON数据转换为CSV格式:

[
  {"Name": "John Doe", "Age": 25, "IsStudent": false},
  {"Name": "Jane Smith", "Age": 30, "IsStudent": true}
]

示例提示2:

将以下JSON对象转换为CSV格式:

{
  "Name": "John Doe",
  "Age": 25,
  "IsStudent": false,
  "Courses": ["Math", "Science"]
}

json_to_excel_mcp_from_url

将提供的URL中的JSON数据转换为Excel数据。

参数

参数 类型 必填 说明
url string Yes 指向JSON文件(.JSON)的url
options object No 用于自定义转换过程的可选配置对象。

注:

  • url应该是可公开访问的。
  • JSON文件应采用.JSON格式。
  • JSON文件应包含有效的JSON数组或对象。JSON模式可在 JSON模式 验证器可在 JSON到Excel Web应用程序.
  • 如果JSON是一个对象数组,则每个对象都将被视为CSV中的一行。
  • 如果JSON是单个对象,它将被转换为具有键值对的CSV。
  • 此工具返回CSV格式的数据,可以轻松转换/导入Excel。

选项对象

选项对象可以包含以下属性:

属性 类型 默认值 描述
proCode string “” JSON到Excel服务的专业代码。
jsonMode string “flat” JSON输出的格式模式:“嵌套”或“flat
delimiter string “.” 使用jsonMode时嵌套JSON键的分隔符:“嵌套”,可接受的分隔符为“.”、“_”、“__”、“/”。
maxDepth string “unlimited” 使用jsonMode时嵌套JSON对象的最大深度:“nested”。对于最大深度,可以接受“无限”、“1”~“20”。

注:

示例提示1

将JSON文件转换为Excel,文件URL:https://mcp.wtsolutions.cn/example.json

示例提示2

(仅适用于您没有URL并且使用在线AI LLM的情况)

我刚刚上传了一个.json文件给您,请提取其URL并将其发送到MCP工具“json_to_excel_MCP_from_URL”,进行json到excel的转换。

响应格式

MCP工具返回具有以下结构的JSON对象:

字段 类型 描述
isError boolean 指示处理请求时是否出错
msg string “成功”或错误描述
data string 转换后的CSV数据字符串,如果有错误,请显示“”。此CSV数据可以轻松导入Excel。

成功响应示例

{
  "content": [{
    "type": "text",
    "text": "{\"isError\":false,\"msg\":\"success\",\"data\":\"Name,Age,IsStudent\nJohn Doe,25,false\nJane Smith,30,true\"}"
  }]
}

上面是MCP工具的响应,在大多数情况下,您的LLM应该解释响应并向您呈现一个JSON对象,例如如下所示。

请注意,不同的LLM模型可能有不同的方式来解释JSON对象,因此请检查LLM模型是否正确解释了JSON对象。

{
  "isError": false,
  "msg": "success",
  "data": "Name,Age,IsStudent\nJohn Doe,25,false\nJane Smith,30,true"
}

失败响应示例

{
  "content": [{
    "type": "text",
    "text": "{\"isError\": true, \"msg\": \"Invalid JSON format\", \"data\": \"\"}"
  }]
}

上面是MCP工具的响应,在大多数情况下,您的LLM应该解释响应并向您呈现一个JSON对象,例如如下所示。

请注意,不同的LLM模型可能有不同的方式来解释JSON对象,因此请检查您的LLM模式是否正确解释了响应。

{
  "isError": true,
  "msg": "Invalid JSON format",
  "data": ""
}

或者,您的LLM也可能会对您说“JSON格式无效,请提供有效的JSON字符串”。

数据类型处理

API自动处理JSON中的不同数据类型:

  • 数字:转换为CSV中的数值
  • 布尔值:转换为“true”/“false”字符串
  • 字符串:必要时跳过并引用
  • 数组:转换为JSON.stringify数组字符串
  • 对象:转换为JSON.stringify对象字符串

错误处理

MCP返回常见问题的描述性错误消息:

  • Invalid JSON format:当输入数据不是有效的JSON字符串时
  • Empty JSON data:当输入数据为空JSON字符串时
  • Network Error when fetching file:从提供的URL下载文件时出错
  • File not found:找不到提供URL处的文件时
  • Server Internal Error:发生意外错误时
  • Pro Code Invalid:当提供的专业代码无效或未订阅时
  • Max 6 rows processed:如果没有提供有效的Pro Code,则只处理前6行数据

服务协议和隐私政策

通过使用JSON到Excel MCP,您同意 服务协议,以及 隐私政策.

定价

免费版,最多处理6行。 专业版,无限制数据处理。

请参考 定价页面 了解更多详情。