Excel to JSON MCP Server

一个用于将Excel文件转换为JSON格式的MCP (Model Context Protocol) 服务器。

功能特性

• Excel转JSON: 将Excel文件转换为JSON格式
• 工作表信息获取: 获取Excel文件的工作表信息
• 自定义列提取: 支持指定需要提取的列
• 空行过滤: 可选择是否过滤空行
• MCP标准: 完全兼容Model Context Protocol标准

安装

通过 npm 安装

npm install -g excel-to-json

本地开发

git clone <repository-url>
cd excel-to-json-mcp
npm install
npm run build

使用方法

作为 MCP 服务器使用

在Claude Desktop或其他MCP客户端中配置：

{
  "mcpServers": {
    "excel2json": {
      "command": "npx",
      "args": [
        "-y",
        "excel-to-json"
      ]
    }
  }
}

本地测试

# 开发模式
npm run dev

# 生产模式
npm start

可用工具

1. excel_to_json

将Excel文件转换为JSON格式。

参数:

• inputFile (必需): Excel文件路径
• outputFile (可选): 输出JSON文件路径，默认为 "output.json"
• sheetName (可选): 工作表名称，默认为 "Final assembly"
• columns (可选): 要提取的列配置数组，默认提取F列和G列
• filterEmptyRows (可选): 是否过滤空行，默认为 true

示例:

{
  "inputFile": "./data/example.xlsx",
  "outputFile": "./output/result.json",
  "sheetName": "Sheet1",
  "columns": [
    {"index": 0, "name": "ID"},
    {"index": 1, "name": "Name"},
    {"index": 2, "name": "Value"}
  ],
  "filterEmptyRows": true
}

2. get_sheet_info

获取Excel文件的工作表信息。

参数:

• inputFile (必需): Excel文件路径

示例:

{
  "inputFile": "./data/example.xlsx"
}

配置示例

Claude Desktop 配置

将以下配置添加到您的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "excel2json": {
      "command": "npx",
      "args": [
        "-y",
        "excel-to-json"
      ]
    }
  }
}

VSCode 配置

如果使用 VSCode MCP 扩展：

{
  "mcp": {
    "servers": {
      "excel2json": {
        "command": "npx",
        "args": ["-y", "excel-to-json"]
      }
    }
  }
}

项目结构

excel-to-json-mcp/
├── src/
│   ├── server.js      # MCP服务器实现
│   └── index.js       # 入口文件
├── build/             # 构建输出目录
├── package.json       # 项目配置
└── README.md         # 说明文档

开发

构建项目

npm run build

开发模式

npm run dev

发布

npm publish

系统要求

• Node.js >= 18.0.0
• 支持ES模块

许可证

MIT License

贡献

欢迎提交Issue和Pull Request。

更新日志

v1.0.0

• 初始版本
• 支持Excel转JSON功能
• 支持工作表信息获取
• 完整的MCP协议支持