mcp-excel-server

mcp-excel-server

使用 Node.js 实现的 Model Context Protocol（MCP）服务，用于操作 Excel 文件。

功能

• 读取文件
• 列出目录
• 搜索文件
• 读取 Excel

注意：服务仅允许在通过 args 指定的目录中执行操作。

🔧 安装

NPM 安装

npm install @qian33/mcp-excel-server

📚 API 参考

资源

• mcp-excel-server 的主要操作接口 file://system

工具函数

📖 读取操作

• read_file_content
  • 读取文件的完整内容
  • 输入：path（字符串）
  • 文本文件使用 UTF-8 编码

🎒写入操作

• write_file_content
  • 使用指定内容创建新文件，或覆盖现有文件
  • 输入：
    • path（字符串）：要写入的文件位置
    • content（字符串）：要写入文件的内容
  • 文本文件使用 UTF-8 编码
  • 写入成功后返回确认消息

📁 目录操作

• list_directory
  • 列出目录内容并标明类型
  • 输入：path（字符串）
  • 返回带有 [FILE] 或 [DIR] 前缀的条目

🔍 读取 Excel 和信息

• get_excel_content

  • 读取文件中的 Excel 内容
  • 输入：path（字符串）
  • Excel 文件使用 UTF-8 编码

• get_online_excel_content

  • 从 URL 获取并读取 Excel 内容
  • 输入：path（字符串）：指向 Excel 文件的在线 URL
  • 以 JSON 数组形式返回 Excel 数据
  • 适用于读取托管在远程服务上的 Excel 文件

📒 写入 Excel

• write_excel_content
  • 使用指定数据创建新的 Excel 文件，或覆盖现有文件
  • 输入：
    • path（字符串）：Excel 文件的位置
    • content（字符串或数组）：要写入 Excel 文件的 JSON 数据
      • 接受 JSON 字符串或直接传入对象数组
      • 每个对象代表 Excel 工作表中的一行
  • 自动创建包含“Sheet1”工作表的工作簿
  • 写入成功后返回确认消息

🔧 使用指南

与 Claude Desktop 集成

将以下配置添加到你的 claude_desktop_config.json 中：

注意：你可以通过将目录挂载到 来对目录进行沙盒限制。添加 ro 标志可将目录设为只读。/projects

NPX 方法

{
  "mcpServers": {
    "mcp-excel-server": {
      "command": "npx",
      "args": [
        "-y",
        "@qian33/mcp-excel-server",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

Bunx 方法

{
  "mcpServers": {
    "mcp-excel-server": {
      "command": "bunx",
      "args": [
        "@qian33/mcp-excel-server",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

在 VS Code 中使用

如需快速安装，请点击下方的安装按钮……

如需手动安装，请将以下 JSON 代码块添加到 VS Code 的用户设置（JSON）文件中。按 Ctrl + Shift + P 并输入 Preferences: Open Settings (JSON) 即可打开该文件。

你也可以选择将其添加到工作区中的 .vscode/mcp.json 文件。这样便可以与他人共享此配置。

请注意，.vscode/mcp.json 文件中不需要 mcp 键。

你可以将沙盒目录挂载到 /projects，以便让服务访问这些目录。添加 ro 标志可使服务只能以只读方式访问该目录。

NPX

{
  "mcp": {
    "servers": {
      "mcp-excel-server": {
        "command": "npx",
        "args": [
          "-y",
          "@qian33/mcp-excel-server",
          "${workspaceFolder}"
        ]
      }
    }
  }
}

🤝 参与贡献

欢迎贡献！参与方式：

1. Fork 此仓库
2. 创建功能分支
3. 编写更改并添加测试
4. 提交拉取请求

请确保你的代码符合项目的编码规范，并包含适当的测试。

📜 许可证

此 MCP 服务采用 MIT 许可证。你可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。详情请参阅仓库中的 LICENSE 文件。