Excel To JSON MCP By WTSolutions

WTSolutions 的 Excel 转 JSON MCP

中文

简介

Excel 转 JSON MCP（模型上下文协议）通过模型上下文协议提供标准化接口，用于将 Excel 和 CSV 数据转换为 JSON 格式。此 MCP 实现提供了两种特定的数据转换工具：

• excel_to_json_mcp_from_data：将制表符分隔的 Excel 数据或逗号分隔的 CSV 文本数据转换为 JSON 格式。
• excel_to_json_mcp_from_url：将提供的 URL 中的 Excel 文件（.xlsx）转换为 JSON 格式

Excel 转 JSON MCP 是 WTSolutions 的 Excel 转 JSON 的一部分：

• Excel 转 JSON Web 应用：直接在 Web 浏览器中将 Excel 转换为 JSON。
• Excel 转 JSON Excel 加载项：在 Excel 中将 Excel 转换为 JSON，与 Excel 环境无缝协作。
• Excel 转 JSON WPS 加载项：在 WPS 中将 Excel 转换为 JSON，与 WPS 环境无缝协作。
• Excel 转 JSON API：通过 HTTPS POST 请求将 Excel 转换为 JSON。
• Excel 转 JSON MCP 服务：通过 AI 模型 MCP SSE/StreamableHTTP 请求将 Excel 转换为 JSON。 （<-- 您正在这里。）

服务配置

可用的 MCP 服务：

使用 Stdio（NPX）

服务配置 JSON：

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

如果您使用免费版：

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

情况 2：专业版

如果您使用专业版（且拥有有效的 proCode）：

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

使用 SSE

自 v1.3.0 起不再支持

使用 Streamable HTTP

自 v1.3.0 起不再支持

MCP 工具

excel_to_json_mcp_from_data

将制表符分隔的 Excel 数据或逗号分隔的 CSV 文本数据转换为 JSON 格式。

参数

参数	类型	必填	说明
data	字符串	是	至少包含两行（标题行 + 数据行）的制表符分隔或逗号分隔文本数据
options	对象	否	用于自定义转换过程的可选配置对象。

注意： 输入数据必须是至少包含两行（标题行 + 数据行）的制表符分隔（Excel）或逗号分隔（CSV）文本。

• 第一行将被视为“标题”行，此 MCP 会将其用作列名，进而用作 JSON 键。
• 后续行将被视为“数据”行，此 MCP 会将其作为 JSON 值处理。

示例提示词 1：

将以下数据转换为 JSON 格式：

Name	Age	IsStudent
John Doe	25	false
Jane Smith	30	true

示例提示词 2：

将以下数据转换为 JSON 格式：

Name,Age,IsStudent
John Doe,25,false
Jane Smith,30,true

excel_to_json_mcp_from_url

将提供的 URL 中的 Excel 文件转换为 JSON 格式。

参数

参数	类型	必填	说明
url	字符串	是	指向 Excel（.xlsx）的 URL
options	对象	否	用于自定义转换过程的可选配置对象。

注意：

• Excel 文件的每个工作表至少应包含两行（标题行 + 数据行）。
  1. 第一行将被视为“标题”行，此 MCP 会将其用作列名，进而用作 JSON 键。
  2. 后续行将被视为“数据”行，此 MCP 会将其作为 JSON 值处理。
• 此 Excel 文件应为“.xlsx”格式。
• Excel 文件的每个工作表都会转换为一个 JSON 对象。
• 每个 JSON 对象都包含“sheetName”（字符串）和“data”（对象数组）属性。
• “data”数组中的每个 JSON 对象都包含与列名对应的属性。
• “data”数组中的每个 JSON 对象都包含与单元格值对应的值。

示例提示词 1

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

示例提示词 2

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

我刚刚上传了一个 .xlsx 文件，请提取它的 URL 并发送给 MCP 工具 'excel_to_json_mcp_from_url'，以便将 Excel 转换为 JSON。

Options Object

如果没有 Pro Code，仍然可以使用此 MCP 工具。不过，最多只会处理 6 行数据。

可选的 options 对象可包含以下属性，用于自定义转换过程。此功能需要有效的 Pro Code（Excel to JSON、JSON to Excel by WTSolutions 订阅），请参阅 定价。

Property	Type	Default	Description
proCode	string	""	用于无限数据处理的 Pro Code，需订阅 Excel to JSON 服务。
jsonMode	string	"flat"	JSON 输出的格式模式："nested" 或 "flat"
header	string	"row"	指定用作标题的行或列："row"（第一行）或 "column"（第一列）
delimiter	string	"."	使用 jsonMode 时，嵌套 JSON 键的分隔符字符："nested" 可接受的分隔符为 "."、"_"、"__"、"/"。
emptyCell	string	"emptyString"	空单元格的处理方式："emptyString"、"null" 或 "exclude"
booleanFormat	string	"trueFalse"	布尔值的格式："trueFalse"、"10" 或 "string"
jsonFormat	string	"arrayOfObject"	JSON 输出的整体格式："arrayOfObject" 或 "2DArray"
singleObjectFormat	string	"array"	结果只有一个对象时的格式："array"（保留为数组）或 "object"（作为单个对象返回）

注意：

• delimiter 仅在 jsonMode 为 "nested" 时生效。
• singleObjectFormat 仅在 jsonFormat 为 "arrayOfObject" 时生效。
• jsonFormat 为 "2DArray" 时，仅在 jsonMode 为 "flat" 的情况下生效。

响应格式

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

Field	Type	Description
isError	boolean	指示处理请求时是否出错
msg	string	'success' 或错误说明
data	string	转换后的数据：使用 URL 时为工作表对象数组，使用直接数据时为字符串；如果出错则为 ''。使用 URL 时，每个工作表对象都包含 'sheetName'（string）和 'data'（对象数组）

成功响应示例

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

以上是 MCP 工具的响应，在大多数情况下，你的大模型应解读该响应并向你展示一个 JSON 对象，例如下方所示。

注意，不同的大模型可能会以不同方式解读 JSON 对象，因此请检查你的大模型是否正确解读了 JSON 对象。

{
  "isError": false,
  "msg": "success",
  "data": "[{\"Name\":\"John Doe\",\"Age\":25,\"IsStudent\":false},{\"Name\":\"Jane Smith\",\"Age\":30,\"IsStudent\":true}]"
}

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

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

示例失败响应

{
  "content": [{
    "type": "text",
    "text": "{\"isError\": true, \"msg\": \"Network Error when fetching file\", \"data\": \"\"}"
  }]
}

以上是 MCP 工具的响应。在大多数情况下，你的大模型应解读该响应，并向你提供一个 JSON 对象，例如如下所示。

请注意，不同的大模型可能会以不同方式解读 JSON 对象，因此请检查你的大模型是否正确解读了响应。

{
  "isError": true,
  "msg": "Network Error when fetching file",
  "data": ""
}

或者，你的大模型也可能会告诉你“获取文件时发生网络错误，请稍后重试”。

数据类型处理

API 会自动检测并转换不同的数据类型：

• 数字：转换为数值
• 布尔值：识别“true”/“false”（不区分大小写），并转换为布尔值
• 日期：检测各种日期格式，并进行相应转换
• 字符串：按字符串值处理
• 空值：表示为空字符串

错误处理

MCP 会针对常见问题返回描述性错误消息：

• Excel Data Format Invalid：输入数据不是以制表符或逗号分隔时
• At least 2 rows are required：输入数据少于 2 行时
• Both data and url received：同时提供“data”和“url”参数时
• Network Error when fetching file：从提供的 URL 下载文件时发生错误
• File not found：在提供的 URL 中找不到文件时
• Blank/Null/Empty cells in the first row not allowed：标题行包含空单元格时
• Server Internal Error：发生意外错误时
• Pro Code Invalid：提供的 Pro Code 无效或未订阅时
• Max 6 rows processed：未提供有效的 Pro Code 时，仅处理数据的前 6 行。

服务协议和隐私政策

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

定价

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

更多详情请参阅定价页面。