基本能力
产品定位
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 应用
从源代码安装
sh
git clone git@github.com: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 文档获取更多帮助
构建独立可执行文件
sh
pip install -r requirements.txt
pip install -r requirements-dev.txt
pyinstaller openpyxl_mcp_server.spec
MacOS 可能需要签名：
sh
codesign --force --deep --sign - dist/openpyxl_mcp_server
