excel-mcp-server

环境要求

• 可用的 uv / uvx 运行环境（README 全程使用 uvx 启动）
• 支持 MCP 的 AI 客户端（Claude、GPT 等）
• 无需本地安装 Microsoft Excel 或 openpyxl（由服务内部处理）
• SSE 模式需本机 8000 端口可用

安装与启动步骤

1. 1准备 uvx 环境

   README 使用 uvx 命令直接运行服务，请先确保本机已具备 uv/uvx 可执行环境，否则后续命令无法执行。

2. 2以 stdio 方式启动

   本地使用（如接入桌面版 AI 客户端）时选择 stdio 传输，由客户端负责拉起进程，一般无需手动常驻执行。

   uvx excel-mcp-server stdio

   复制

3. 3配置 MCP 客户端

   把 stdio 配置写入 AI 客户端的 MCP 配置文件，客户端会自动以 uvx 启动 excel-mcp-server。

   {
      "mcpServers": {
         "excel": {
            "command": "uvx",
            "args": ["excel-mcp-server", "stdio"]
         }
      }
   }

   复制

4. 4以 SSE 方式启动

   需要远程或独立运行时使用 SSE 传输，README 标注该方式已废弃，仍可临时使用。

   uvx excel-mcp-server sse

   复制

5. 5接入 SSE 地址

   SSE 模式在本地 8000 端口提供 /sse 端点，客户端配置改用 url 字段而不再用 command。

   {
      "mcpServers": {
         "excel": {
            "url": "http://localhost:8000/sse"
         }
      }
   }

   复制

关键配置

如何确认成功

在 AI 客户端的工具列表中出现 Excel 相关工具并能成功读写工作簿；SSE 模式下访问 http://localhost:8000/sse 有响应。

常见问题

注意事项

• 本教程仅依据 README 节选中出现的命令与配置编写，streamable HTTP 的命令未给出，故未列出。
• README 将 SSE 标注为 deprecated，新接入建议使用 stdio 方式。
• 配置文件需写入 AI 客户端自己的 MCP 配置位置，该项目本身不生成该文件。