openpyxl_mcp_server

openpyxl_mcp_server

site icon
2025.05.09 0
PythonExcel 数据处理MCP 服务开发效率
openpyxl_mcp_server 是一个围绕 OpenPyXl Python 库的轻量级封装,将其部分功能作为 Model Context Protocol (MCP) 服务器暴露出来。这使得 Claude 和其他 MCP 客户端能够从 Excel 文件中获取数据。该服务主要用于通过 MCP 协议与 Excel 文件交互,支持数据查询和分析。
View on GitHub

Overview

基本能力

产品定位

openpyxl_mcp_server 是一个 MCP 服务器,旨在通过 MCP 协议提供对 Excel 文件的数据访问能力,支持数据查询和分析。

核心功能

  1. 通过 MCP 协议暴露 OpenPyXl 库的功能,支持从 Excel 文件中读取数据。
  2. 支持与 Claude 等 MCP 客户端集成,实现 Excel 文件的自动化查询和分析。
  3. 提供多种配置方式,包括直接下载可执行文件或从源代码安装。

适用场景

  1. 数据分析:通过 MCP 客户端查询 Excel 文件中的数据,进行快速分析。
  2. 自动化报表:自动从 Excel 文件中提取数据并生成报告。
  3. 表单填写:帮助用户填写复杂的 Excel 表单。

工具列表

  1. openpyxl_mcp_server:主服务工具,提供 Excel 文件的数据访问能力。
  2. pyinstaller:用于将 Python 代码打包为可执行文件。
  3. codesign(macOS):用于签名可执行文件,确保其可运行。

常见问题解答

  1. Windows 用户如何运行可执行文件?
  2. Windows 可能会阻止运行从互联网下载的可执行文件,用户需要在浏览器或 Windows Defender 中点击“保留”或“保留 anyway”以允许运行。
  3. 如何配置 Claude Desktop?
  4. 需要在 Claude Desktop 的配置文件中添加 MCP 服务器的路径,并重启 Claude 应用。
  5. 如何从源代码安装?
  6. 克隆仓库后,创建虚拟环境并安装依赖,然后通过 Python 运行脚本。

使用教程

使用依赖

  1. 确保已安装 Python 3.x。
  2. 确保已安装 Git(如需从源代码安装)。

安装教程

  1. 下载可执行文件
  2. GitHub Releases 下载对应操作系统的可执行文件。
  3. macOS 用户需要设置可执行权限: sh chmod a+x /path/to/openpyxl_mcp_server
  4. 从源代码安装sh 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

调试方式

  1. 测试 MCP 服务器
  2. 确保 MCP 服务器已正确配置到 Claude Desktop 或其他 MCP 客户端。
  3. 使用示例提示测试 Excel 文件的数据查询功能。
  4. 查看日志
  5. 如果从源代码运行,可以查看 Python 脚本的输出日志以排查问题。

标签信息

安装类型

sse

产品定位

Excel 数据处理, MCP 服务

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。