free-mcp-excel

# Excel MCP Server 本地Excel MCP（Model Context Protocol）服务，提供轻量、开箱即用的Excel文件解析能力。 ## 特性 - ✅ **纯本地运行**：通过stdio通信，无端口监听、无网络依赖 - ✅ **多格式支持**：自动识别并兼容 `.xlsx` 和 `.xls` 两种格式 - ✅ **灵活部署**：支持uvx自动管理依赖或pip手动安装 - ✅ **标准化协议**：遵循MCP协议规范，兼容Claude Desktop、Cursor等AI客户端 - ✅ **健壮性保障**：内置文件校验、格式识别、异常处理等机制 ## 快速开始 ### 环境要求 - Python 3.8+ - MCP客户端（如Claude Desktop、Cursor等） ### 安装方式 #### 方式一：从PyPI安装（推荐） **使用 pip 安装（推荐，自动安装所有依赖）**： ```bash pip install free-mcp-excel ``` 这会自动安装所有必需的依赖，包括： - `mcp>=0.9.0` - MCP SDK - `openpyxl>=3.0.0` - Excel .xlsx 处理 - `pandas>=1.5.0` - 数据处理（约11.8MB） - `xlrd>=2.0.0` - Excel .xls 读取 - `xlwt>=1.3.0` - Excel .xls 写入 - `pycel>=1.0b0` - 公式计算引擎 **或使用 uvx（首次安装较慢）**： ```bash uvx free-mcp-excel ``` **注意**： - `uvx` 首次安装需要下载约30MB依赖（pandas 11.8MB, numpy 15.6MB, networkx 1.8MB等），可能需要几分钟 - 如果网络较慢或遇到 "No server info found" 错误，建议使用 `pip install` 方式 #### 方式二：从源码安装 ```bash # 克隆项目 git clone https://gitee.com/fanzhiyu/free-mcp-excel.git cd free-mcp-excel # 安装依赖（自动安装所有必需库） pip install -r requirements.txt # 或使用开发模式安装（推荐） pip install -e . ``` #### 方式三：手动安装依赖（如果自动安装失败） 如果自动安装遇到问题，可以手动安装依赖： ```bash # 安装核心依赖 pip install mcp>=0.9.0 pip install openpyxl>=3.0.0 pip install pandas>=1.5.0 pip install xlrd>=2.0.0 pip install xlwt>=1.3.0 pip install pycel>=1.0b0 # 然后安装包 pip install free-mcp-excel ``` 或者一次性安装： ```bash pip install mcp openpyxl pandas xlrd xlwt pycel pip install free-mcp-excel ``` ### 配置MCP客户端 #### Cursor IDE配置 在项目根目录创建或编辑 `.cursor/mcp.json`： **推荐配置（使用 pip 安装后）**： ```json { "mcpServers": { "free-mcp-excel": { "command": "python", "args": ["-m", "free_mcp_excel"] } } } ``` **或使用 uvx（首次安装较慢）**： ```json { "mcpServers": { "free-mcp-excel": { "command": "uvx", "args": ["free-mcp-excel"] } } } ``` #### Claude Desktop配置 编辑配置文件（macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`）： **推荐配置（使用 pip 安装后）**： ```json { "mcpServers": { "free-mcp-excel": { "command": "python", "ar…