openpyxl-mcp-server

🚀 OpenpyxL-MCP 服务器

OpenpyxL-MCP 服务器是一款基于 MCP 协议的文件解析工具，专注于处理 Excel 文件（.xlsx）。它能高效解析文件并从中提取关键信息，为用户在数据处理方面提供了极大的便利。

✨ 主要特性

• 文件解析：可精准解析标准的 Excel 文件格式。
• 数据提取：能从表格里提取如名称、地址、城市、邮政编码等关键信息。
• 条件搜索：支持依据用户给定的关键词或条件，在文件内容中进行搜索。

💻 使用示例

基础用法

以下展示了不同场景下使用 OpenpyxL-MCP 服务器处理 Excel 文件的示例。

示例 1

• 提示：使用文件/Users/jonas/Downloads/resorts.xlsx中的数据回答以下问题：酒店名称是什么？地址是什么？城市和邮政编码是什么？
• 输出：

太浩湖度假村  
地址：999 Yosemite Way, Lake Tahoe, CA 96148  
城市：Lake Tahoe，邮编：96148

示例 2

• 提示：使用文件/Users/jonas/Downloads/resorts.xlsx中的数据回答以下问题：在加利福尼亚州（CA）有哪些度假村？在犹他州（UT）有哪些度假村？
• 输出： 在加利福尼亚州的度假村：
• 优胜美地度假村
• 太浩湖度假村

在犹他州的度假村：

• 帕克城度假村
• 阿尔卑斯度假村

示例 3

• 提示：使用文件/Users/jonas/Downloads/homes.xlsx中的数据回答以下问题：在伊利诺伊州（IL）有哪些房子出售？在佛罗里达州（FL）有哪些房子出售？

• 输出： 在伊利诺伊州的房子：

• 位置：123 Maple Street, Chicago, IL 60601

• 类型：独栋住宅，价格：$500,000

• 位置：456 Oak Avenue, Evanston, IL 60637

• 类型：联排别墅，价格：$600,000

在佛罗里达州的房子：

• 位置：789 Pine Boulevard, Orlando, FL 32801
• 类型：公寓，价格：$300,000

示例 4

• 提示：使用文件/Users/jonas/Downloads/sales.xlsx中的数据回答以下问题：哪个月份的销售额最高？最高销售额是多少？
• 输出： 最高销售额发生在：
• 时间：2023年12月
• 销售额：$1,200,000

📦 安装指南

独立可执行文件构建

若要创建独立的可执行文件（无需 Python 安装），可按以下步骤操作：

1. 确保已安装所有依赖项：

   pip install -r requirements.txt
   pip install -r requirements-dev.txt
   

2. 构建可执行文件：

   pyinstaller openpyxl_mcp_server.spec
   

生成的可执行文件将位于 dist 目录中。在 Windows 上，文件名为 openpyxl_mcp_server.exe；在 macOS 上，文件名为 openpyxl_mcp_server。

⚠️ 重要提示

在 macOS 上构建时，可能需要对可执行文件进行签名才能正常运行。可以使用以下命令进行签名：

codesign --force --deep --sign - dist/openpyxl_mcp_server