AI全托管处理EXCEL（并接入AI平台）

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

以下是针对 excel-mcp-server 仓库的 Windows 系统安装、配置和使用完整步骤：

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

在 PowerShell/CMD 中执行：

powershell 复制代码

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

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

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

powershell 复制代码

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

安装依赖并打包安装：

powershell 复制代码

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

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

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

powershell 复制代码

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

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

PowerShell/CMD 中执行：

powershell 复制代码

uvx excel-mcp-server stdio

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

json 复制代码

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

powershell 复制代码

uvx excel-mcp-server sse

客户端配置示例：

json 复制代码

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

powershell 复制代码

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

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

客户端配置示例：

json 复制代码

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

若启动时提示 uvx 找不到：

powershell 复制代码

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

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

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

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