螺旋-xls-mcp服务器

Spire.XLS MCP 服务器是什么？

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

主要特性：

• 高保真地将Excel转换为PDF、HTML、CSV、图像、XML等多种格式。
• 创建、修改和管理Excel工作簿。
• 管理和控制工作表：重命名、移动、隐藏、冻结窗格等。
• 管理工作表和单元格范围。
• 读写数据。
• 分析Excel数据。
• 添加各种图表类型以从数据中创建视觉Excel仪表板。
• 创建和操作透视表，以总结、分析、探索和展示Excel数据。

如何使用Spire.XLS MCP服务器？

先决条件

• 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工具集成

以下视觉指南说明了将Spire.XLS MCP服务器与支持的AI开发环境集成的三步过程：

步骤1和步骤2：启动服务器并配置AI工具

步骤3：通过AI界面使用Excel功能

Cursor IDE

1. 将此配置添加到Cursor：

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

2. Excel工具将通过您的AI助手提供。

远程托管及传输协议

此服务器使用服务器发送事件（SSE）传输协议。对于不同的用例：

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

   • 使用Supergateway将SSE转换为stdio

2. 托管您的MCP服务器：

   • 远程MCP服务器指南

环境变量

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

可用工具

服务器提供了一整套Excel操作工具。以下是主要类别：

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

参见TOOLS.md获取所有可用工具的完整文档。

Spire.XLS MCP服务器常见问题？

Q1. 我可以使用Spire.XLS MCP服务器处理任意目录吗？

是的，Spire.XLS MCP服务器适用于任何目录。

Q2. Spire.XLS MCP服务器是否免费使用？

是的，它采用MIT许可证，允许自由使用和修改。

Q3. Spire.XLS MCP服务器支持哪些编程语言？

它是用Python构建的。

许可证

MIT