Excel MCP 服务器

一个提供全面的 Excel 文件管理和数据分析能力的 MCP 服务器。

特性

• Excel 文件操作

  • 读取多种 Excel 格式 (XLSX, XLS, CSV, TSV, JSON)
  • 写入和更新 Excel 文件
  • 获取文件信息和工作表名称

• 数据分析

  • 汇总统计和描述性分析
  • 数据质量评估
  • 数据透视表
  • 筛选和查询数据

• 可视化

  • 从 Excel 数据生成图表和图形
  • 创建数据预览
  • 将可视化结果导出为图片

安装

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

# Using uv (recommended)
uv init excel-mcp-server
cd excel-mcp-server
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Or using pip
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

1. 安装依赖项：

# Using uv
uv pip install -r requirements.txt

# Or using 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 许可证