Spire XLS MCP Server

Spire.XLS MCP Server 说明文档

什么是 Spire.XLS MCP Server？

Spire.XLS MCP Server 是一款强大的解决方案，可让 AI Agent 通过 Model Context Protocol（MCP）处理 Excel 文件。它完全独立运行，系统无需安装 Microsoft Office。借助此工具，AI Agent 可以轻松创建、读取、修改和转换 Excel 工作簿。

主要功能：

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

如何使用 Spire.XLS MCP Server？

前提条件

• Python 3.10 或更高版本

安装

1. 克隆代码仓库：

git clone https://github.com/EiceblueCloud/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 工具。

远程托管与传输协议

此服务使用 Server-Sent Events（SSE）传输协议。针对不同用例：

1. 与 Claude Desktop 搭配使用（需要 stdio）：

   • 使用 Supergateway 将 SSE 转换为 stdio

2. 托管 MCP 服务：

   • 远程 MCP 服务指南

环境变量

变量	说明	默认值
FASTMCP_PORT	服务端口	8000
EXCEL_FILES_PATH	Excel 文件目录	./excel_files

可用工具

此服务提供了一套全面的 Excel 操作工具。以下是主要类别：

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

请参阅 TOOLS.md，查看所有可用工具的完整文档。

Spire.XLS MCP Server 常见问题？

我可以将 Spire.XLS MCP Server 用于任意目录吗？ 可以，Spire.XLS MCP Serer 适用于任意目录。

Spire.XLS MCP Server 可以免费使用吗？ 可以，它采用 MIT License 授权，允许免费使用和修改。

Spire.XLS MCP Server 支持哪些编程语言？ 它使用 Python 构建。

许可证

MIT