最近帮长辈安装AI提效，电脑都是Windows用的较多的是excel。一般用AI调用处理Excel都是汇调用Python写代码，而且容易出现格式错误。mcp的方式可以免除困扰并且比较快速准确，节省credits（这都是钱啊）。

以下是针对 excel-mcp-server 仓库的 Windows 系统安装、配置和使用完整步骤：
原库 ：https://github.com/haris-musa/excel-mcp-server

一、前置条件

1. 安装 Python：确保 Windows 系统安装了 Python 3.8+ 版本（推荐 3.10+），并勾选「Add Python to PATH」选项。
   • 下载地址：https://www.python.org/downloads/windows/
2. 验证 Python：打开 PowerShell 或 CMD，执行 python --version 或 py --version，能显示版本号即安装成功。

二、安装 excel-mcp-server

方式 1：通过 PyPI 安装（推荐）

在 PowerShell/CMD 中执行：

# 升级 pip（可选）
python -m pip install --upgrade pip

# 安装 excel-mcp-server
pip install excel-mcp-server

方式 2：从源码安装（如需修改代码）

1. 克隆仓库（需先安装 Git）：

   git clone https://github.com/haris-musa/excel-mcp-server.git
   cd excel-mcp-server
   

2. 安装依赖并打包安装：

   # 安装 hatch 构建工具
   pip install hatch
   # 构建包
   hatch build
   # 安装构建后的包
   pip install dist\*.whl
   

三、配置环境变量（按需）

根据使用的传输方式，可选配置环境变量：

1. 配置 Excel 文件路径（SSE/Streamable HTTP 模式需要）

PowerShell 中临时设置（仅当前会话有效）：

$env:EXCEL_FILES_PATH="E:\MyExcelFiles"  # 替换为你的 Excel 文件存储路径
$env:FASTMCP_PORT="8007"  # 自定义端口（默认 8017）

2. 永久设置环境变量（可选）

• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在「用户变量」中新建：
  • 变量名：EXCEL_FILES_PATH，变量值：你的 Excel 文件路径（如 E:\MyExcelFiles）
  • 变量名：FASTMCP_PORT，变量值：自定义端口（如 8007）

四、启动服务（三种传输方式）

方式 1：Stdio 模式（本地使用，推荐入门）

PowerShell/CMD 中执行：

uvx excel-mcp-server stdio

• 适配 AI 客户端的配置示例（如 Cursor 等支持 MCP 的工具）：

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

方式 2：SSE 模式（已废弃，不推荐）

uvx excel-mcp-server sse

• 客户端配置示例：

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

方式 3：Streamable HTTP 模式（推荐远程连接）

# 直接启动（使用默认端口 8017）
uvx excel-mcp-server streamable-http

# 或指定端口启动
$env:FASTMCP_PORT="8007"
uvx excel-mcp-server streamable-http

• 客户端配置示例：

  {
     "mcpServers": {
        "excel": {
           "url": "http://localhost:8007/mcp"
        }
     }
  }
  

五、验证运行

1. 启动服务后，无报错即表示运行成功；
2. 可通过 AI 客户端（如 Cursor）配置 MCP 服务器，测试 Excel 操作（如创建工作簿、读写数据等）；
3. 若启动时提示 uvx 找不到：

   # 安装 uv 工具
   pip install uv
   # 重新执行启动命令
   uvx excel-mcp-server stdio  # 或其他模式
   

六、常见问题解决

1. 中文路径/文件名报错：确保 Excel 文件路径不含中文、空格或特殊字符；
2. 端口被占用：修改 FASTMCP_PORT 环境变量为未占用端口（如 8008、8080）；
3. 依赖缺失：若提示 openpyxl 等模块缺失，执行 pip install openpyxl 补充依赖；
4. 权限不足：以「管理员身份」运行 PowerShell/CMD，或更换 Excel 文件存储路径（如用户目录 C:\Users\你的用户名\ExcelFiles）。

七、核心功能使用

服务启动后，AI 客户端可调用以下核心能力：

• 创建/修改 Excel 工作簿、工作表；
• 读写单元格数据、设置公式；
• 应用单元格格式（字体、颜色、边框）；
• 创建图表、透视表、Excel 表格；
• 复制/重命名/删除工作表等。

完整工具列表可参考仓库的 TOOLS.md 文件。