使用说明
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)一起使用
- 构建服务器
npm install
npm run build
- 创建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" }
}
}
}
- 重新启动克劳德桌面
- 退出并重新打开Claude Desktop,以便加载新的MCP服务器。
- 验证是否检测到服务器
- 在Claude Desktop中,打开“设置”→ MCP服务器并确认
excel已列出并连接。
- 与Claude聊天示例
- 在新聊天中,说:
- “使用excel MCP使用open_workbook打开我的工作簿,位置为'/aolute/path/to/your.xlsx'。”
- “然后列出工作表。”
- “读取'Sheet1'上的单元格A1。”
- “读取'Sheet1'上的范围A1:C3。”
如果文件存在并且可读,Claude将调用这些工具并返回结果。使用绝对路径。
