Spire Xls MCP Server

🚀 Spire.XLS MCP 服务器是什么？

Spire.XLS MCP 服务器是一个强大的解决方案，它使 AI 代理能够使用模型上下文协议（MCP）处理 Excel 文件。它完全独立，无需在系统上安装 Microsoft Office。借助此工具，AI 代理可以无缝地创建、读取、编辑和转换 Excel 工作簿。

✨ 主要特性

• 高保真转换：支持将 Excel 转换为 PDF、Excel 转换为 HTML、Excel 转换为 CSV、Excel 转换为图像、Excel 转换为 XML 等。
• 工作簿管理：能够创建、修改和管理 Excel 工作簿。
• 工作表控制：可对工作表进行重命名、移动、隐藏、冻结窗格等操作。
• 数据管理：支持管理工作表和单元格区域，读写数据，分析 Excel 数据。
• 可视化操作：可添加各种图表类型，根据数据创建可视化的 Excel 仪表盘。
• 数据透视：创建和操作数据透视表，以汇总、分析、探索和展示 Excel 数据。

📦 安装指南

前置条件

• Python 3.10 或更高版本

安装步骤

1. 克隆仓库：

git clone https://github.com/eiceblue/spire-xls-mcp-server.git
cd spire-xls-mcp-server

2. 使用 uv 进行安装：

uv pip install -e .

启动服务器

• 默认端口（8000）启动：

uv run spire-xls-mcp-server

• 自定义端口（如 8080）启动：

# Bash/Linux/macOS
export FASTMCP_PORT=8080 && uv run spire-xls-mcp-server

# Windows PowerShell
$env:FASTMCP_PORT = "8080"; uv run spire-xls-mcp-server

🚀 快速开始

与 AI 工具集成

Cursor IDE

1. 在 Cursor 中添加以下配置：

{
  "mcpServers": {
    "excel": {
      "url": "http://localhost:8000/sse",
      "env": {
        "EXCEL_FILES_PATH": "/path/to/excel/files"
      }
    }
  }
}

2. 通过 AI 助手即可使用 Excel 工具。

远程托管与传输协议

本服务器使用服务器发送事件（SSE）传输协议。针对不同使用场景：

1. 与 Claude Desktop 配合使用（需要 stdio）：
   • 使用 Supergateway 将 SSE 转换为 stdio。
2. 托管自己的 MCP 服务器：
   • 参考 远程 MCP 服务器指南。

📚 详细文档

环境变量

可用工具

服务器提供了一套全面的 Excel 操作工具，主要分类如下：

• 基本操作：创建、读取、写入和删除 Excel 工作表或工作簿。
• 数据处理：读写单元格数据、应用公式、排序和过滤。
• 格式设置：应用样式、合并单元格、设置字体和颜色。
• 高级功能：创建图表、数据透视表、条件格式设置。
• 文件转换：高保真地将 Excel 转换为 PDF、HTML、CSV、图像、XML 等。

完整的工具文档请参考 TOOLS.md。

常见问题解答

Q1. 我可以在任何目录中使用 Spire.XLS MCP 服务器吗？ A1. 可以，Spire.XLS MCP 服务器可在任何目录中使用。

Q2. Spire.XLS MCP 服务器是否免费使用？ A2. 是的，它遵循 MIT 许可证，允许免费使用和修改。

Q3. Spire.XLS MCP 服务器支持哪些编程语言？ A3. 它是用 Python 构建的。

📄 许可证

本项目采用 MIT 许可证。