excel-to-json

免费MCP服务：Excel CSV 转 JSON MCP by WTSolutions 文档

简介

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

  • excel_to_json_mcp_from_data：转换制表符分隔或逗号分隔的文本数据
  • excel_to_json_mcp_from_url：从提供的 URL 转换 Excel 数据

服务器配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "mcpServers": {
    "excel_to_json_by_WTSolutions": {
      "args": [
        "mcp-remote",
        "https://mcp.wtsolutions.cn/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 字符串 是 制表符分隔或逗号分隔的文本数据，至少包含两行（标题行 + 数据行）

示例请求

1
2
3
4
5
6
{
  "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

示例请求

1
2
3
4
5
6
{
  "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”（对象数组）

示例成功响应

1
2
3
4
5
6
{
  "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

  • 输入数据必须是制表符分隔或逗号分隔的文本，至少包含两行（标题行 + 数据行）。
    1. 第一行将被视为“标题”行，本 API 会将其用作列名，进而作为 JSON 键。
    2. 后续行将被视为“数据”行，本 API 会将其用作 JSON 值。

excel_to_json_mcp_from_url

  • Excel 文件的每个工作表应至少包含两行（标题行 + 数据行）。
    1. 第一行将被视为“标题”行，本 API 会将其用作列名，进而作为 JSON 键。
    2. 后续行将被视为“数据”行，本 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：发生意外错误时

定价

目前免费。

捐赠

https://buymeacoffee.com/wtsolutions