Ishay Almuly

Excel MCP 服务

MCP 服务让 Claude 能够全面读取、写入和分析 Excel 与 CSV 文件。提供 37 个工具，涵盖基础单元格读取到财务建模。

安装

选项 1：npm（推荐）

npm install -g excel-csv-mcp-server

然后添加到 MCP 客户端：

Claude Code：

claude mcp remove excel-csv  # if previously added
claude mcp add excel-csv --transport stdio excel-csv-mcp-server

Claude Desktop / Cursor — 添加到 MCP 配置（claude_desktop_config.json 或 Cursor 的 mcp.json）：

{
  "mcpServers": {
    "excel-csv": {
      "command": "excel-csv-mcp-server"
    }
  }
}

选项 2：npx（无需安装）

无需全局安装，可直接运行：

Claude Code：

claude mcp add excel-csv stdio npx -- excel-csv-mcp-server

Claude Desktop / Cursor：

{
  "mcpServers": {
    "excel-csv": {
      "command": "npx",
      "args": ["-y", "excel-csv-mcp-server"]
    }
  }
}

选项 3：从源码安装

git clone https://github.com/ishayoyo/excel-mcp.git
cd excel-mcp
npm install
npm run build

Claude Code：

claude mcp add excel-csv stdio node /path/to/excel-mcp/dist/index.js

Claude Desktop / Cursor：

{
  "mcpServers": {
    "excel-csv": {
      "command": "node",
      "args": ["/path/to/excel-mcp/dist/index.js"]
    }
  }
}

功能

类别	工具	示例
读取与导航	read_file、get_cell、get_range、get_headers、search、filter_rows、aggregate	读取文件、搜索值、筛选行、汇总列
大型文件	read_file_chunked、get_file_info	分块读取 100MB 以上的文件
写入与格式设置	write_file、add_sheet、write_multi_sheet、export_analysis、format_cells、auto_fit_columns	创建 Excel/CSV 文件、创建含公式的多工作表、设置单元格样式
分析	statistical_analysis、correlation_analysis、data_profile、pivot_table	统计、相关性、数据概况、数据透视表
财务	dcf_analysis、budget_variance_analysis、ratio_analysis、scenario_modeling、trend_analysis	DCF 估值、预算与实际对比、财务比率、假设情景分析
数据清理	find_duplicates、data_cleaner、vlookup_helper	删除重复项、修正日期/电话号码/姓名、跨文件查找
批量操作	bulk_aggregate_multi_files、bulk_filter_multi_files	跨多个文件汇总/筛选
验证	validate_data_consistency	跨文件引用完整性检查
AI 驱动	evaluate_formula、parse_natural_language、explain_formula、smart_data_analysis、ai_provider_status	计算公式、将自然语言转换为公式、AI 分析

AI 提供商（可选）

如需使用 AI 驱动的工具（parse_natural_language、explain_formula、smart_data_analysis），请创建 .env 文件：

cp .env.example .env

ANTHROPIC_API_KEY=your-key
OPENAI_API_KEY=your-key
DEEPSEEK_API_KEY=your-key
GEMINI_API_KEY=your-key

配置任意一个提供商即可。无需任何密钥也可使用本地回退方案。

设置提供商密钥后，数据会离开你的设备。 AI 工具会将正在分析的 电子表格内容发送给你配置的提供商（Anthropic、OpenAI、DeepSeek 或 Gemini）。 不设置密钥即可确保所有操作都在本地进行——内置的回退提供商不会进行网络调用。

安全

服务仅读取和写入 .csv、.xlsx 和 .xls 文件，并以本地进程的形式通过 stdio 运行，使用你自己的用户权限。

限制文件访问

默认情况下，你指定的任何路径都允许访问，因为该工具的用途就是打开磁盘上任意位置的电子表格。如果你向不完全信任的调用方开放服务，或者希望防止恶意电子表格诱导模型将文件写入意外位置，可以将访问范围限制在一个目录中：

EXCEL_MCP_WORKSPACE_ROOT=/path/to/your/data

此后，所有读写操作都会解析到该目录内，任何越界路径都会被拒绝。取消设置该变量即可恢复默认行为。

请注意，路径解析后才会检查是否位于指定目录内，因此会处理 .. 路径遍历，但不会跟随符号链接：指向目录外部的目录内符号链接仍会解析到外部。请勿在工作区中放置不受信任的符号链接。

CSV 公式注入

电子表格应用会将以 =、+、-、@、制表符或回车符开头的单元格内容作为公式求值。写入 CSV 时，此服务会在这类内容前添加单引号，使其保持为纯文本（CWE-1236）。像 -5 和 +1.5 这样的普通数字会被识别并保持原样，因此数值数据往返转换后不会改变。

此保护默认启用。若要输出原始值：

EXCEL_MCP_CSV_FORMULA_GUARD=off

Excel 输出不受影响——.xlsx 单元格会写入为带类型的字符串，永远不会作为公式求值。

许可证

MIT