openpyxl_mcp_server
2025.03.21
8
PythonExcel 数据处理AI 助手集成开发效率
openpyxl-mcp-server 是一个基于 OpenPyXl Python 库的轻量级封装，将其部分功能作为模型上下文协议（MCP）服务器暴露出来。该服务允许 Claude 和其他 MCP 客户端从 Excel 文件中获取数据。
View on GitHub
Overview
基本能力
产品定位
openpyxl-mcp-server 主要用于通过 MCP 协议提供 Excel 文件的数据访问能力，使得 AI 助手如 Claude 可以直接读取和分析 Excel 文件内容。
核心功能
- 提供 Excel 文件数据的读取能力
- 支持通过 MCP 协议与 AI 助手交互
- 支持 Windows 和 MacOS 平台
- 提供预编译的可执行文件和源代码安装两种方式
适用场景
- 数据分析：从 Excel 文件中提取和分析数据
- 财务管理：查询和分析财务数据
- 表单填写：协助填写复杂的 Excel 表单
- 数据查询：从大型 Excel 数据集中查询特定信息
工具列表
- openpyxl_mcp_server：主程序，提供 Excel 数据访问服务
- openpyxl_mcp_server.exe：Windows 版本的可执行文件
常见问题解答
- Windows 可能会阻止运行下载的可执行文件，需要手动允许
- 配置更改后需要完全退出并重启 Claude 应用才能生效
- 对于大型 Excel 文件可能会遇到上下文限制问题
使用教程
使用依赖
- 需要安装 Python（如果从源代码运行）
- 需要安装 Claude Desktop 应用
安装教程
- 从 GitHub 发布页面下载最新版本的可执行文件
- MacOS:
openpyxl_mcp_server -
Windows:
openpyxl_mcp_server.exe -
配置 Claude Desktop
- 打开 Claude Desktop 设置
- 导航到开发者部分
- 编辑配置文件
claude_desktop_config.json -
添加以下配置（根据平台调整路径）：
json { "mcpServers": { "inspect_excel_xlsx_file": { "command": "PATH_TO_EXECUTABLE", "args": [] } } } -
完全退出并重启 Claude 应用
从源代码安装
git clone [email protected]:jonemo/openpyxl-mcp-server.git
cd openpyxl-mcp-server
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
调试方式
- 确保可执行文件路径配置正确
- 检查 Claude 应用是否完全重启
- 尝试简单的 Excel 文件查询测试
- 查看 Anthropic 的 MCP 文档获取更多帮助
构建独立可执行文件
pip install -r requirements.txt
pip install -r requirements-dev.txt
pyinstaller openpyxl_mcp_server.spec
MacOS 可能需要签名：
codesign --force --deep --sign - dist/openpyxl_mcp_server