Excel to JSON MCP by WTSolutions

中文

介绍

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

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

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

• Excel to JSON Web 应用程序：直接在Web浏览器中将Excel转换为JSON。
• Excel to JSON Excel 插件：在Excel中无缝地将Excel转换为JSON。
• Excel to JSON API：通过HTTPS POST请求将Excel转换为JSON。
• Excel to JSON MCP 服务：通过AI模型MCP SSE/StreamableHTTP请求将Excel转换为JSON。 （<-- 您在这里。）

服务器配置

可用的MCP服务器：

使用Stdio(NPX)

服务器配置JSON:
json
{
"mcpServers": {
"excel2json": {
"args": [
"mcp-remote",
"https://mcp.wtsolutions.cn/sse",
"--transport",
"sse-only"
],
"command": "npx",
"tools": [
"excel_to_json_mcp_from_data",
"excel_to_json_mcp_from_url"
]
}
}
}

使用SSE

传输方式: SSE

URL: https://mcp.wtsolutions.cn/excel-to-json-mcp-sse

服务器配置JSON:

json
{
"mcpServers": {
"excel2jsonsse": {
"type": "sse",
"url": "https://mcp.wtsolutions.cn/sse"
}
}
}

使用可流式处理的HTTP

传输方式: 可流式处理的HTTP

URL: https://mcp.wtsolutions.cn/excel-to-json-mcp-shttp

服务器配置JSON:

json
{
"mcpServers": {
"excel2jsonmcp": {
"type": "streamableHttp",
"url": "https://mcp.wtsolutions.cn/mcp"
}
}
}

MCP 工具

excel_to_json_mcp_from_data

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

参数

注意：
输入数据必须是至少包含两行（标题行 + 数据行）的制表符分隔（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格式。

参数

注意：

• 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 LLM 时适用）

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

响应格式

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

成功响应示例

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

以上是来自 MCP 工具的响应，在大多数情况下，您的 LLM 应该解释响应并为您提供一个 JSON 对象，例如如下所示。

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

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

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

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

失败响应示例

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

以上是来自 MCP 工具的响应，在大多数情况下，您的 LLM 应该解释响应并为您提供一个 JSON 对象，例如如下所示。

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

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

或者也有可能您的 LLM 会告诉您“获取文件时网络错误，请稍后再试”。

数据类型处理

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

• 数字：转换为数值
• 布尔值：识别 'true'/'false'（不区分大小写）并转换为布尔值
• 日期：检测各种日期格式并适当转换
• 字符串：作为字符串值处理
• 空值：表示为空字符串

错误处理

MCP 返回常见问题的描述性错误消息：- Excel 数据格式无效: 当输入数据不是制表符分隔或逗号分隔时

• 至少需要2行: 当输入数据少于2行时
• 同时接收了数据和URL: 当同时提供了'data'和'url'参数时
• 从提供的URL获取文件时发生网络错误: 当从提供的URL下载文件时出现错误
• 文件未找到: 当提供的URL处的文件无法找到时
• 首行不允许有空白/空值/空单元格: 当标题行包含空单元格时
• 服务器内部错误: 当发生意外错误时

服务协议和隐私政策

通过使用Excel到JSON MCP，您同意服务协议和隐私政策。

定价

目前免费。

捐赠

https://buymeacoffee.com/wtsolutions