Information
Excel to JSON MCP by WTSolutions
中文
介绍
Excel to JSON MCP(Model Context Protocol)提供了一个标准化的接口,用于通过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 App: 在Web浏览器中直接将Excel转换为JSON。
Excel to JSON Excel Add-in: 在Excel环境中无缝地将Excel转换为JSON。
Excel to JSON API: 通过HTTPS POST请求将Excel转换为JSON。
Excel to JSON MCP Service: 通过AI Model 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格式。
参数
参数类型是否必需描述datastring是至少包含两行(标题行 + 数据行)的制表符分隔或逗号分隔的文本数据
注意:
输入数据必须是至少包含两行(标题行 + 数据行)的制表符分隔(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格式。
参数
参数类型是否必需描述urlstring是指向Excel (.xlsx) 的URL
注意:
Excel文件中的每个工作表应至少包含两行(标题行 + 数据行)。
第一行将被视为“标题”行,此MCP将使用它作为列名,随后成为JSON键。
后续行将被视为“数据”行,此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 对象:
字段类型描述isError布尔值表示处理请求时是否有错误发生msg字符串'success' 或错误描述data字符串转换后的数据作为 sheet 对象数组(如果使用 URL),直接数据作为字符串(如果使用直接数据),如果有错误则为空字符串。每个 sheet 对象包含 'sheetName'(字符串)和 'data'(对象数组)(如果使用 URL)
成功响应示例
json
\{
"content": [\{
"type": "text",
"text": "\{"isError","msg":"success","data":"[\{\"Name\":\"John Doe\",\"Age\":25,\"IsStudent\"\},\{\"Name\":\"Jane Smith\",\"Age\":30,\"IsStudent\"\}]"\}"
\}]
\}
以上是来自 MCP 工具的响应,在大多数情况下,您的 LLM 应该解释响应并为您提供一个 JSON 对象,例如下面所示。
注意,不同的 LLM 模型可能有不同的方式来解释 JSON 对象,请检查您的 LLM 模型是否正确解释了 JSON 对象。
json
\{
"isError": false,
"msg": "success",
"data": "[\{"Name":"John Doe","Age":25,"IsStudent"\},\{"Name":"Jane Smith","Age":30,"IsStudent"\}]"
\}
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