AI导哈

Excel文件操作服务器

一个基于Node.js的服务器，实现Model Context Protocol (MCP)协议，提供Excel文件的读写、目录操作和搜索功能。适用于需要在受控环境中处理Excel文件的开发场景。

  • by qianO33
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 qiano33/mcp-excel-server

使用说明

mcp-excel服务器

实现excel文件操作的模型上下文协议（MCP）的Node.js服务器。

特性

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

备注：服务器只允许在通过指定的目录内进行操作 args.

🔧 安装

NPM安装

npm install @qian33/mcp-excel-server

📚 api参考

资源

  • 主mcp-excel服务器操作界面 file://system

工具功能

📖 阅读操作

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

🎒书写操作

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

📁 目录操作

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

🔍 阅读Excel和信息

  • get_excel_content

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

  • 获取在线内容

    • 从URL获取和读取Excel内容
    • 输入： path （string）：Excel文件的在线URL
    • 以JSON数组的形式返回Excel数据
    • 可用于读取远程服务器上托管的Excel文件

📒 编写Excel

  • write_excel_content
    • 创建新的Excel文件或用指定数据覆盖现有文件
    • 输入：
      • path （string）：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代码

要快速安装，请单击下面的安装按钮。..

对于手动安装，请将以下JSON块添加到VS Code中的用户设置（JSON）文件中。您可以按 Ctrl + Shift + P 和打字 Preferences: Open Settings (JSON).

您可以选择将其添加到名为的文件中 .vscode/mcp.json 在您的工作空间中。这将允许您与他人共享配置。

请注意 mcp 中不需要密钥 .vscode/mcp.json 文件。

您可以通过将沙盒目录挂载到以下位置来向服务器提供沙盒目录 /projects.添加 ro 标志将使目录对服务器只读。

NPX

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

🤝 贡献

欢迎投稿！贡献：

  1. 分叉存储库
  2. 创建要素分支
  3. 通过测试实现您的更改
  4. 提交拉取请求

请确保您的代码符合项目的编码标准，并包含适当的测试。

📜 许可证

此MCP服务器根据MIT许可证获得许可。您可以根据MIT许可条款和条件自由使用、修改和分发软件。有关详细信息，请参阅存储库中的LICENSE文件。

相关 MCP