Excel读取服务

基于TypeScript的Excel MCP服务器,提供对Excel文件的只读访问功能,适用于需要读取Excel数据的开发场景。

  • by VishakAmin
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 vishakamin/mcp_excel

使用说明

Excel MCP服务器(第一阶段MVP)

基于TypeScript的MCP服务器提供对Excel(.xlsx)的只读访问,使用 exceljs.

特性

  • 打开工作簿
  • 列出工作表
  • 读取单元格值
  • 读取范围
  • 获取工作簿元数据

设置

npm install
npm run build
npm start

开发模式:

npm run dev

环境:套 LOG_LEVEL (错误|警告|信息|调试)。

MCP工具

  • open_workbook({file_path})
  • list_worksheets()
  • read_cell({工作表,单元格})
  • read_range({工作表,范围})
  • get_workbook_info()

测试

npm test

循序渐进:与Claude Desktop(macOS)一起使用

  1. 构建服务器
npm install
npm run build
  1. 创建Claude桌面MCP配置
  • 路径: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 为此服务器添加条目(调整 cwd 到您的项目路径):
{
  "mcpServers": {
    "excel": {
      "command": "node",
      "args": ["/Users/macbook/Projects/mcp_excel/dist/index.js"],
      "env": { "LOG_LEVEL": "info" }
    }
  }
}
  1. 重新启动克劳德桌面
  • 退出并重新打开Claude Desktop,以便加载新的MCP服务器。
  1. 验证是否检测到服务器
  • 在Claude Desktop中,打开“设置”→ MCP服务器并确认 excel 已列出并连接。
  1. 与Claude聊天示例
  • 在新聊天中,说:
    • “使用excel MCP使用open_workbook打开我的工作簿,位置为'/aolute/path/to/your.xlsx'。”
    • “然后列出工作表。”
    • “读取'Sheet1'上的单元格A1。”
    • “读取'Sheet1'上的范围A1:C3。”

如果文件存在并且可读,Claude将调用这些工具并返回结果。使用绝对路径。