簡介
Excel 轉 JSON MCP(模型上下文協議)提供了一個標準化接口,用于通過模型上下文協議將 Excel 和 CSV 數據轉換為 JSON 格式。此 MCP 實現提供了兩個專門用于數據轉換的工具:
- excel_to_json_mcp_from_data:轉換制表符分隔或逗號分隔的文本數據
- excel_to_json_mcp_from_url:從提供的 URL 轉換 Excel 數據
服務器配置
{"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 | 字符串 | 是 | 制表符分隔或逗號分隔的文本數據,至少包含兩行(標題行 + 數據行) |
示例請求
{"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 |
示例請求
{"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”(對象數組) |
示例成功響應
{"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
:發生意外錯誤時
定價
目前免費。
捐贈
https://buymeacoffee.com/wtsolutions