sheetex-mcp-server

English | 简体中文

基于 sheetex 的 MCP 服务器，用于将 AI 对话中生成的表格导出为 Excel 文件，并应用基础样式。

📌 适用场景：当你在使用支持 MCP 的 AI 客户端时，可让 AI 自动将结构化数据保存为本地 Excel 文件，提升数据处理效率。

🌟 主要功能

• 将对话中生成的 Markdown 表格转换为 Excel 文件
• 支持多目录与别名管理，限制访问目录，主动选择保存位置
• 保留基础表格样式（标题加粗、重点文字加粗、斜体、删除线，根据文字数量估算列宽等）
• 兼容主流 MCP 客户端

🛠 可用工具

save-with-sheetex - 保存表格为 Excel 文件

将对话中生成的表格保存为 .xlsx 文件。

| 参数 | 类型 | 说明 | |-----------|--------|-----------------------------| | folderName | string | 保存目录（对应 EXPORT_DIRS 中的别名） | | fileName | string | 输出文件名（无需 .xlsx 后缀） | | caption | string | 表格标题（可选，显示在 Excel 第一行合并居中） | | table | string | Markdown 格式的表格数据 |

🚀 使用方法

1. 使用 npx 运行

EXPORT_DIRS=/path/to/dir#alias_name;/path/to/document npx sheetex-mcp-server

2. 使用 Smithery CLI 安装

npx -y @smithery/cli install sheetex-mcp-server \
  --client claude \
  --config '{"env": {"EXPORT_DIRS": "/path/to/dir#alias_name;/path/to/document"}}'

3. 通过配置文件集成

Windows 平台

{
  "mcpServers": {
    "sheetex": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "sheetex-mcp-server"],
      "env": {
        "EXPORT_DIRS": "/path/to/dir#alias_name;/path/to/document"
      }
    }
  }
}

Linux/MacOS：

{
  "mcpServers": {
    "sheetex": {
      "command": "npx",
      "args": ["-y", "sheetex-mcp-server"],
      "env": {
        "EXPORT_DIRS": "/path/to/dir#alias_name;/path/to/document"
      }
    }
  }
}

⚙️ 环境变量：EXPORT_DIRS

指定允许导出的目录列表，支持别名配置。

• 格式：多个目录用分号 ; 分隔，每个目录可选附加 #别名
• 别名规则：
  • 若指定 #alias_name，AI 将通过该别名识别目录
  • 若未指定，使用目录路径的最后一级名称作为默认别名
• 默认行为：当 AI 无法判断保存位置时，使用第一个目录

示例

EXPORT_DIRS=/Users/me/reports#财务报表;/home/user/docs#文档

AI 可识别的目录别名为：财务报表 和 文档，用户可在提示词中指定保存位置，如：“将表格保存到 财务报表 目录”。

🤝 贡献

欢迎提交 Issue 或 Pull Request 来帮助改进本项目！
无论是功能建议、文档优化还是 Bug 修复，我们都十分感谢。

📄 许可证

本项目采用 MIT 许可证。详情请见 LICENSE 文件。