mcp-excel-server

🚀 Excel MCP 服务器

Excel MCP 服务器是一个强大的工具，它提供了全面的 Excel 文件管理和数据分析功能，能帮助用户高效处理 Excel 数据。

🚀 快速开始

Excel MCP 服务器可提供 Excel 文件管理与数据分析功能，你可按以下步骤进行安装和集成。

✨ 主要特性

• Excel 文件操作
  • 支持读取多种 Excel 格式，如 XLSX、XLS、CSV、TSV、JSON。
  • 能够写入和更新 Excel 文件。
  • 可获取文件信息和工作表名称。
• 数据分析
  • 可进行汇总统计和描述性分析。
  • 能对数据质量进行评估。
  • 可以创建数据透视表。
  • 支持进行数据筛选和查询。
• 可视化
  • 能根据 Excel 数据生成图表和图形。
  • 可创建数据预览。
  • 能将可视化结果导出为图片。

📦 安装指南

1. 创建一个新的 Python 环境（推荐）：

# 使用 uv（推荐）
uv init excel-mcp-server
cd excel-mcp-server
uv venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

# 或使用 pip
python -m venv .venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

2. 安装依赖项：

# 使用 uv
uv pip install -r requirements.txt

# 或使用 pip
pip install -r requirements.txt

📚 详细文档

集成到 Claude Desktop

1. 安装 Claude Desktop
2. 打开设置并转到开发者选项卡
3. 编辑 claude_desktop_config.json：

{
  "mcpServers": {
      "command": "uvx",
      "args": [
        "mcp-excel-server"
      ],
      "env": {
        "PYTHONPATH": "/path/to/your/python"
      }
  }
}

可用工具

文件读取

• read_excel：读取 Excel 文件
• get_excel_info：获取文件详细信息
• get_sheet_names：列出工作表名称

数据分析

• analyze_excel：执行统计分析
• filter_excel：按条件筛选数据
• pivot_table：创建数据透视表
• data_summary：生成全面的数据摘要

数据可视化

• export_chart：生成图表，支持的图表类型包括折线图、柱状图、散点图和直方图

文件操作

• write_excel：写入新的 Excel 文件
• update_excel：更新现有 Excel 文件

可用资源

• excel://{file_path}：获取文件内容
• excel://{file_path}/info：获取文件结构信息
• excel://{file_path}/preview：生成数据预览图片

提示模板

• analyze_excel_data：用于 Excel 数据分析的引导式模板
• create_chart：帮助创建数据可视化
• data_cleaning：协助进行数据清理

💻 使用示例

基础用法

以下是一些使用示例：

- “分析我的 sales_data.xlsx 文件”
- “为 product_sales.csv 创建柱状图”
- “筛选 employees.xlsx 中年龄超过 30 岁的员工”
- “生成部门销售额的透视表”

🔧 技术细节

安全注意事项

• 只从指定路径读取文件
• 限制文件大小
• 防止意外文件覆盖
• 严格控制数据转换操作

依赖项

• pandas
• numpy
• matplotlib
• seaborn

📄 许可证

本项目采用 MIT License。