免费MCP: JSON 转 Excel MCP

发布于:2025-08-05 ⋅ 阅读:(8) ⋅ 点赞:(0)

介绍

JSON 转 Excel MCP(模型上下文协议)提供了一个标准化接口,用于使用模型上下文协议将 JSON 数据转换为 CSV 格式字符串。此 MCP 实现提供了两个特定的数据转换工具:

  • json_to_excel_mcp_from_data:将 JSON 数据字符串转换为 CSV 格式。
  • json_to_excel_mcp_from_url:将提供的 URL 中的 JSON 文件(.json 格式)转换为 CSV 格式字符串。

JSON 转 Excel MCP 是 WTSolutions 的 JSON 转 Excel 工具包的一部分:

服务器配置

可用的 MCP 服务器(SSE 和 Streamable HTTP):

使用Stdio (NPX)

服务器配置 JSON:

{
  "mcpServers": {
    "json_to_excel": {
      "args": [
        "mcp-remote",
        "https://mcp2.wtsolutions.cn/sse",
        "--transport",
        "sse-only"
      ],
      "command": "npx"
    }
  }
}

使用 SSE

传输方式:SSE

URL: https://mcp2.wtsolutions.cn/sse

服务器配置 JSON:

{
  "mcpServers": {
    "json2excelsse": {
      "type": "sse",
      "url": "https://mcp2.wtsolutions.cn/sse"
    }
  }
}

使用 Streamable HTTP

传输方式:Streamable HTTP

URL: https://mcp2.wtsolutions.cn/mcp

服务器配置 JSON:

{
  "mcpServers": {
    "json2excelmcp": {
      "type": "streamableHttp",
      "url": "https://mcp2.wtsolutions.cn/mcp"
    }
  }
}

MCP 工具

json_to_excel_mcp_from_data

将 JSON 数据字符串转换为 CSV 格式字符串。

参数
参数 类型 是否必需 描述
data string 要转换为 CSV 的 JSON 数据字符串。必须是有效的 JSON 数组或对象。

注意:

  • 输入数据必须是有效的 JSON 字符串。JSON格式要求可在 JSON格式要求 获取,验证器可在 JSON 转 Excel Web 应用 使用。
  • 如果 JSON 是对象数组,每个对象将被视为 CSV 中的一行。
  • 如果 JSON 是单个对象,它将被转换为包含键值对的 CSV。
  • CSV 将包含基于 JSON 对象中键的标题。
  • 此工具返回可轻松转换/导入到 Excel 的 CSV 格式数据。
示例提示 1:

将以下 JSON 数据转换为 CSV 格式:

[
  {"Name": "张三", "Age": 25, "IsStudent": false},
  {"Name": "李四", "Age": 30, "IsStudent": true}
]
示例提示 2:

将以下 JSON 对象转换为 CSV 格式:

{
  "Name": "张三",
  "Age": 25,
  "IsStudent": false,
  "Courses": ["数学", "科学"]
}

json_to_excel_mcp_from_url

将提供的 URL 中的 JSON 数据转换为 Excel 数据。

参数
参数 类型 是否必需 描述
url string 指向 JSON 文件(.json)的 URL

注意:

  • URL 应该是可公开访问的。
  • JSON 文件应该是 .json 格式。
  • JSON 文件应该包含有效的 JSON 数组或对象。JSON格式要求可在 JSON格式要求 获取,验证器可在 JSON 转 Excel Web 应用 获取。
  • 如果 JSON 是对象数组,每个对象将被视为 CSV 中的一行。
  • 如果 JSON 是单个对象,它将被转换为包含键值对的 CSV。
  • 此工具返回可轻松转换/导入到 Excel 的 CSV 格式数据。

示例提示 1

将 JSON 文件转换为 Excel,文件 URL: https://mcp.wtsolutions.cn/example.json

示例提示 2

(仅当您没有 URL 并使用在线 AI LLM 时适用)

我刚刚上传了一个 .json 文件给您,请提取其 URL 并将其发送到 MCP 工具 ‘json_to_excel_mcp_from_url’,以进行 JSON 到 Excel 的转换。

响应格式

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

字段 类型 描述
isError boolean 指示处理请求时是否出错
msg string ‘success’ 或错误描述
data string 转换后的 CSV 数据字符串,出错时为空字符串。此 CSV 数据可轻松导入到 Excel。

成功响应示例

{
  "content": [{
    "type": "text",
    "text": "{\"isError\":false,\"msg\":\"success\",\"data\":\"Name,Age,IsStudent\n张三,25,false\n李四,30,true\"}"
  }]
}

以上是 MCP 工具的响应,在大多数情况下,您的 LLM 应该解释响应并向您呈现一个 JSON 对象,例如如下所示。

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

{
  "isError": false,
  "msg": "success",
  "data": "Name,Age,IsStudent\n张三,25,false\n李四,30,true"
}

失败响应示例

{
  "content": [{
    "type": "text",
    "text": "{\"isError\": true, \"msg\": \"Invalid JSON format\", \"data\": \"\"}"
  }]
}

以上是 MCP 工具的响应,在大多数情况下,您的 LLM 应该解释响应并向您呈现一个 JSON 对象,例如如下所示。

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

{
  "isError": true,
  "msg": "Invalid JSON format",
  "data": ""
}

或者,您的 LLM 可能会对您说"无效的 JSON 格式,请提供有效的 JSON 字符串"。

数据类型处理

API 自动处理 JSON 中的不同数据类型:

  • 数字:转换为 CSV 中的数值
  • 布尔值:转换为 ‘true’/‘false’ 字符串
  • 字符串:必要时进行转义和引用
  • 数组:转换为 JSON.stringify 数组字符串
  • 对象:转换为 JSON.stringify 对象字符串

错误处理

MCP 为常见问题返回描述性错误消息:

  • Invalid JSON format:当输入数据不是有效的 JSON 字符串时
  • Empty JSON data:当输入数据是空的 JSON 字符串时
  • Network Error when fetching file:当从提供的 URL 下载文件时出错时
  • File not found:当找不到提供的 URL 上的文件时
  • Server Internal Error:当发生意外错误时

定价

目前免费。

捐赠

https://buymeacoffee.com/wtsolutions


网站公告

今日签到

点亮在社区的每一天
去签到