Spreadsheet MCP

🚀 電子表格 MCP 服務器 (@zephyr-mcp/spreadsheet)

這是一個基於 TypeScript 的模型上下文協議 (MCP) 服務器，可藉助 LLM 或 API 集成，實現對 CSV/XLSX 電子表格文件的查看、篩選、排序和更新操作，為處理電子表格數據提供了便捷的解決方案。

🚀 快速開始

此包設計為直接使用 npx 運行，典型用法無需安裝。不過，你需要滿足以下先決條件：

• Node.js v18+ (推薦 LTS 版本)

在 stdio 模式下啟動服務器 (用於與 Cline 等工具集成)：

npx @zephyr-mcp/spreadsheet

服務器啟動後，會通過標準輸入/輸出監聽 MCP 命令。

✨ 主要特性

• 查看電子表格信息並預覽行
• 按列和條件篩選行
• 按列排序行 (升序/降序)
• 向現有 XLSX 文件添加新工作表或創建新文件
• 支持 CSV 和 XLSX 文件
• 以包含二維數組的 JSON 字符串形式返回結果 (用於查看/篩選/排序)
• 技術棧：TypeScript, fastmcp, papaparse, xlsx, zod

📦 安裝指南

開發環境設置

1. 克隆倉庫：

   git clone https://github.com/your-username/spreadsheet-mcp.git # 替換為你的倉庫 URL
   cd spreadsheet-mcp
   

2. 安裝依賴：

   npm install
   

啟動開發服務器

npm run dev

💻 使用示例

示例工具

• view_spreadsheet: 查看文件信息並預覽指定行數。返回包含文件信息和預覽數據（二維數組）的 JSON 字符串。rows 參數指定預覽行數（0 表示僅表頭，默認為 10，無最大限制）。
• filter_spreadsheet: 按列和條件篩選行。返回包含篩選結果（二維數組）的 JSON 字符串。rows 參數指定返回的最大行數（默認為所有匹配行，無最大限制）。
• sort_spreadsheet: 按列排序行。返回包含排序結果（二維數組）的 JSON 字符串。rows 參數指定返回的最大行數（默認為所有行，無最大限制）。
• update_spreadsheet_with_new_sheet: 將數據寫入 XLSX 文件的新工作表

📚 詳細文檔

測試

npm test

發佈

1. 更新包版本：

   npm version major/minor/patch
   

2. 提交更改並推送到遠程倉庫。
3. 構建併發布：

   npm run build
   npm publish
   

項目結構

- src/
  ├── server.ts            # MCP 服務器入口, 工具註冊
  └── spreadsheetUtils.ts  # 電子表格解析、篩選、格式化、寫入
- tests/
  └── server.test.ts

📄 許可證

MIT License © 2025 Zephyr

👨‍💻 作者

Zephyr