Json To Excel By Wtsolutions

WTSolutions 的 JSON to Excel MCP

中文

简介

JSON to Excel MCP（Model Context Protocol）通过 Model Context Protocol 提供标准化接口，用于将 JSON 数据转换为 CSV 格式字符串。此 MCP 实现提供了两种特定的数据转换工具：

• json_to_excel_mcp_from_data：将 JSON 数据字符串转换为 CSV 格式。
• json_to_excel_mcp_from_url：将指定 URL（.json 格式）中的 JSON 文件转换为 CSV 格式字符串。

JSON to Excel MCP 是 WTSolutions 的 JSON to Excel 工具包的一部分：

• JSON to Excel Web App：在 Web 浏览器中直接将 JSON 转换为 Excel。
• JSON to Excel Excel Add-in：在 Excel 中将 JSON 转换为 Excel，可与 Excel 环境无缝协作。
• JSON to Excel WPS Add-in：在 WPS 中将 JSON 转换为 Excel，可与 WPS 环境无缝协作。
• JSON to Excel API：通过 HTTPS POST 请求将 JSON 转换为 Excel。
• JSON to Excel MCP Service：通过 AI Model MCP SSE/StreamableHTTP 请求将 JSON 转换为 Excel。（<-- 您当前所在的位置。）

服务配置

可用的 MCP 服务（SSE 和 Streamable HTTP）：

使用 Stdio（NPX）

服务配置 JSON：

情况 1：免费版（最多处理 6 行数据）

如果您使用免费版：

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

情况 2：Pro 版

如果您使用 Pro 版（并拥有有效的 proCode）：

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

使用 SSE

从 v0.3.0 开始不再支持

使用 Streamable HTTP

从 v0.3.0 开始不再支持

MCP 工具

json_to_excel_mcp_from_data

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

参数

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

注意：

• 输入数据必须是有效的 JSON 字符串。JSON 架构请参阅 JSON Schema，验证器请参阅 JSON to Excel Web App。
• 如果 JSON 是对象数组，每个对象都将作为 CSV 中的一行。
• 如果 JSON 是单个对象，则会转换为包含键值对的 CSV。
• CSV 将根据 JSON 对象中的键生成表头。
• 此工具会返回 CSV 格式的数据，可轻松转换为 Excel 文件或导入 Excel。

Options 对象

options 对象可以包含以下属性：

属性	类型	默认值	说明
proCode	string	""	JSON to Excel 服务的 Pro Code。
jsonMode	string	"flat"	JSON 输出的格式模式："nested" 或 "flat"。
delimiter	string	"."	使用 jsonMode："nested" 时，嵌套 JSON 键的分隔符；可接受的分隔符为 "."、"_"、"__"、"/"。
maxDepth	string	"unlimited"	使用 jsonMode："nested" 时，嵌套 JSON 对象的最大深度。maxDepth 可接受 "unlimited"、"1" ~ "20"。

注意：

• 如果您没有有效的 Pro Code，最多会处理 6 行。
• 详细的转换规则请参阅 Features。

提示词示例 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	是	指向 JSON 文件（.json）的 URL
options	object	否	用于自定义转换流程的可选配置对象。

注意：

• url 应可公开访问。
• JSON 文件应为 .json 格式。
• JSON 文件应包含有效的 JSON 数组或对象。JSON 架构见 JSON Schema，验证器见 JSON to Excel Web App。
• 如果 JSON 是对象数组，则每个对象都将作为 CSV 中的一行。
• 如果 JSON 是单个对象，则会将其转换为包含键值对的 CSV。
• 此工具会返回 CSV 格式的数据，可轻松转换为 Excel 或导入 Excel。

Options 对象

options 对象可包含以下属性：

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

注意：

• 如果没有有效的 Pro Code，最多会处理 6 行。
• 详细的转换规则可在 Pro Features 中查看。

示例提示词 1

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

示例提示词 2

（仅适用于没有 URL 且正在使用在线 AI 大模型的情况）

我刚刚向你上传了一个 .json 文件，请提取其 URL，并将其发送给 MCP 工具 'json_to_excel_mcp_from_url'，以将 JSON 转换为 Excel。

响应格式

MCP 工具会返回一个具有以下结构的 JSON 对象：

字段	类型	描述
isError	boolean	指示处理请求时是否发生错误
msg	string	'success' 或错误描述
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 工具的响应，在大多数情况下，你的大模型应解读该响应并向你展示一个 JSON 对象，例如如下所示。

注意，不同的大模型可能会以不同方式解读 JSON 对象，因此请检查你的大模型是否正确解读了该 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：提供的 Pro Code 无效或未订阅时
• Max 6 rows processed：未提供有效的 Pro Code 时，只会处理前 6 行数据

服务协议和隐私政策

使用 JSON to Excel MCP 即表示你同意服务协议和隐私政策。

定价

免费版最多处理 6 行。 Pro 版可处理无限量数据。

详情请参阅定价页面。