Excel MCP Server

Excel MCP Server

site icon
2025.04.04 24
PythonExcel 文件管理数据分析数据可视化文件管理
mcp-excel-server 是一个提供全面 Excel 文件管理和数据分析能力的 MCP 服务器。它支持多种 Excel 格式的读写操作,包括 XLSX、XLS、CSV、TSV 和 JSON,并提供数据分析和可视化功能。
View on GitHub

Overview

基本能力

产品定位

mcp-excel-server 是一个专注于 Excel 文件管理和数据分析的工具,旨在帮助用户高效处理和分析 Excel 数据。

核心功能

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

  • 数据分析

  • 摘要统计和描述性分析
  • 数据质量评估
  • 数据透视表
  • 数据过滤和查询

  • 可视化

  • 从 Excel 数据生成图表和绘图
  • 创建数据预览
  • 将可视化导出为图像

适用场景

  • 数据分析师需要快速分析 Excel 数据
  • 开发人员需要自动化处理 Excel 文件
  • 业务人员需要生成数据可视化报告

工具列表

  • 文件读取
  • 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 文件

常见问题解答

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

使用教程

使用依赖

  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
  1. 安装依赖:
# 使用 uv
uv pip install -r requirements.txt

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

安装教程

  1. 按照上述步骤创建 Python 环境并安装依赖。
  2. 确保已安装 Claude Desktop
  3. 打开设置并转到开发者选项卡。
  4. 编辑 claude_desktop_config.json
{
  "mcpServers": {
      "command": "uvx",
      "args": [
        "mcp-excel-server"
      ],
      "env": {
        "PYTHONPATH": "/path/to/your/python"
      }
  }
}

调试方式

安装完成后,可以通过以下命令测试服务是否正常运行:

uvx mcp-excel-server

确保服务能够正常启动并响应请求。

许可证

该项目遵循 MIT 开源许可条款。