简介
Excel 转 JSON MCP(模型上下文协议)提供了一个标准化接口,用于通过模型上下文协议将 Excel 和 CSV 数据转换为 JSON 格式。此 MCP 实现提供了两个专门用于数据转换的工具:
- excel_to_json_mcp_from_data:转换制表符分隔或逗号分隔的文本数据
- excel_to_json_mcp_from_url:从提供的 URL 转换 Excel 数据
服务器配置
json
{
"mcpServers": {
"excel_to_json_by_WTSolutions": {
"args": [
"mcp-remote",
"https://mcp.wtsolutions.cn/excel-to-json-mcp-sse"
],
"command": "npx",
"tools": [
"excel_to_json_mcp_from_data",
"excel_to_json_mcp_from_url"
]
}
}
}
MCP 工具
excel_to_json_mcp_from_data
将制表符分隔或逗号分隔的文本数据转换为 JSON 格式。
参数
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
data | 字符串 | 是 | 制表符分隔或逗号分隔的文本数据,至少包含两行(标题行 + 数据行) |
示例请求
json
{
"tool": "excel_to_json_mcp_from_data",
"parameters": {
"data": "Name\tAge\tIsStudent\nJohn Doe\t25\tfalse\nJane Smith\t30\ttrue"
}
}
excel_to_json_mcp_from_url
从提供的 URL 转换 Excel 或 CSV 文件为 JSON 格式。
参数
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
url | 字符串 | 是 | 指向 Excel(.xlsx)或 CSV 文件的 URL |
示例请求
json
{
"tool": "excel_to_json_mcp_from_url",
"parameters": {
"url": "https://example.com/path/to/your/file.xlsx"
}
}
响应格式
MCP 工具返回具有以下结构的 JSON 对象:
字段 | 类型 | 描述 |
---|---|---|
isError | 布尔值 | 指示处理请求时是否发生错误 |
msg | 字符串 | "success"(成功)或错误描述 |
data | 字符串 | 使用 URL 时,为工作表对象数组形式的转换后数据;使用直接数据时,为字符串形式;发生错误时为空字符串。使用 URL 时,每个工作表对象包含"sheetName"(字符串)和"data"(对象数组) |
示例成功响应
json
{
"content": [{
"type": "text",
"text": "{\"isError\":false,\"msg\":\"success\",\"data\":\"[{\"Name\":\"John Doe\",\"Age\":25,\"IsStudent\":false},{\"Name\":\"Jane Smith\",\"Age\":30,\"IsStudent\":true}]\"}"
}]
}
数据类型处理
API 会自动检测并转换不同的数据类型:
- 数字:转换为数值类型
- 布尔值:识别"true"/"false"(不区分大小写)并转换为布尔值
- 日期:检测各种日期格式并进行适当转换
- 字符串:视为字符串值
- 空值:表示为空字符串
对数据和 URL 的要求
excel_to_json_mcp_from_data
- 输入数据必须是制表符分隔或逗号分隔的文本,至少包含两行(标题行 + 数据行)。
- 第一行将被视为"标题"行,本 API 会将其用作列名,进而作为 JSON 键。
- 后续行将被视为"数据"行,本 API 会将其用作 JSON 值。
excel_to_json_mcp_from_url
- Excel 文件的每个工作表应至少包含两行(标题行 + 数据行)。
- 第一行将被视为"标题"行,本 API 会将其用作列名,进而作为 JSON 键。
- 后续行将被视为"数据"行,本 API 会将其用作 JSON 值。
- 此 Excel 文件应为".xlsx"格式。
- Excel 文件的每个工作表将被转换为一个 JSON 对象。
- 每个 JSON 对象将具有"sheetName"(字符串)和"data"(对象数组)属性。
- "data"数组中的每个 JSON 对象将具有与列名对应的属性。
- "data"数组中的每个 JSON 对象将具有与单元格值对应的数值。
错误处理
API 针对常见问题返回描述性错误消息:
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
:发生意外错误时
定价
目前免费。