FastExcel MCP 服务器

Java 服务器，实现了模型上下文协议 (MCP)，用于 Excel 操作，并具有标准化的表头到列的关系。

功能

• 读取 Excel 文件（XLSX、XLS、CSV）的表头和数据行。
• 验证输入路径是否在配置的工作区内。
• 支持多个工作表和自定义表头行。
• 检索数据行的总数（不包括表头）。

注意: 该服务器仅允许在通过 env: MCP_WORKSPACES 指定的目录中进行操作。

API

工具

• get_total_rows_number

  • 获取 Excel 文件中数据行的总数（不包括表头行）。
  • 输入：
    • excelPath (字符串): Excel 文件的绝对或相对路径。
    • headRowNumber (整数): 表头所在的行号（从 1 开始的索引）。
    • sheetName (字符串, 可选): 要读取的工作表的名称。如果为空，则默认为第一个工作表。
  • 返回数据行的总数，类型为整数。

• get_sheet_names

  • 从 Excel 文件中检索所有工作表的名称及其索引。
  • 输入：
    • excelPath (字符串): Excel 文件的绝对或相对路径。
  • 返回一个 JSON 对象列表，包含工作表编号和工作表名称。

• read_head_spec

  • 解析并返回 Excel 文件中的表头信息。
  • 输入：
    • excelPath (字符串): Excel 文件的绝对或相对路径。
    • headRowNumber (整数): 表头所在的行号（从 1 开始的索引）。
    • sheetName (字符串, 可选): 要读取的工作表的名称。如果为空，则默认为第一个工作表。
  • 返回一个排序后的 JSON 对象列表，包含列索引和表头标题。

• read_rows_spec

  • 解析并返回 Excel 文件中的数据行，并与表头关联。
  • 输入：
    • excelPath (字符串): Excel 文件的绝对或相对路径。
    • headRowNumber (整数): 表头所在的行号（从 1 开始的索引）。
    • readRowNumbers (整数, 可选): 要读取的数据行数（不包括表头）。如果为空，则读取所有行。
    • sheetName (字符串, 可选): 要读取的工作表的名称。如果为空，则默认为第一个工作表。
  • 返回一个 JSON 列表，包含与表头链接的行数据。

与 Claude Desktop 一起使用

将以下内容添加到您的 claude_desktop_config.json：

Java

{
  "mcpServers": {
    "fastexcel": {
      "command": "java",
      "args": [
        "-jar",
        "<YOUR_PATH>/fastexecl-mcp-server-0.0.1-SNAPSHOT.jar"
      ],
      "env": {
        "MCP_WORKSPACES": "<YOUR_MULTIPLE_WORKSPACES_SEPARATED_BY_COMMAS>"
      }
    }
  }
}

构建

必需

• JDK 17+ GraalVM
• Maven 3.9.6+

Java 构建：

mvn clean package -DskipTests=true

许可证

此 MCP 服务器在 Apache License 2.0 许可下发布。 有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。

---

如果您需要进一步的定制或集成细节，请告诉我！