MCP Server Spreadsheet

mcp服务器电子表格

mcp名称：io.github.marekrost/mcp服务器预说明书

数据优先MCP服务器，用于读取和写入电子表格文件(.xlsx, .csv, .ods).

主要特点

• 多格式 --使用Excel(.xlsx)，CSV(.csv)，以及OpenDocument(.ods)通过统一的工具界面创建文件。
• 双模式 --单元级工作簿操作和DuckDB驱动的SQL查询引擎，在同一文件上自由交错。
• 工作簿要点 --工作表、行、列、单元格、搜索。
• 仅数据 --保留现有格式，但只读取和写入值。
• 无状态 --每次呼叫都指定 file 和 sheet 明确地；没有句柄或会话。
• 原子能节省 --写入到临时文件，然后 os.replace() 进入目标路径。
• 写入时的类型强制 --数字字符串变成数字，其他一切都是文本。
• 跨表SQL --通过内存中的DuckDB进行JOIN、GROUP BY、聚合、子查询；突变会写回文件。
• CSV作为单页工作簿 --CSV文件被视为一个工作簿，其中有一张名为 default.

需求

• Python 3.13+

安装

来自PyPI（推荐）

无需本地结账——只需配置您的MCP客户端（见下文）。

来源（用于开发）

git clone https://github.com/marekrost/mcp-server-spreadsheet.git
cd mcp-server-spreadsheet
uv sync

用法

克劳德桌面版

添加到您的 claude_desktop_config.json:

使用PyPI（推荐）：

{
  "mcpServers": {
    "mcp-server-spreadsheet": {
      "command": "uvx",
      "args": ["mcp-server-spreadsheet"]
    }
  }
}

使用本地来源：

{
  "mcpServers": {
    "mcp-server-spreadsheet": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-server-spreadsheet", "main.py"]
    }
  }
}

克劳德代码

添加到您的 .mcp.json:

使用PyPI（推荐）：

{
  "mcpServers": {
    "mcp-server-spreadsheet": {
      "command": "uvx",
      "args": ["mcp-server-spreadsheet"]
    }
  }
}

使用本地来源：

{
  "mcpServers": {
    "mcp-server-spreadsheet": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-server-spreadsheet", "main.py"]
    }
  }
}

独立（标准传输）

# PyPI
uvx mcp-server-spreadsheet

# Local source
uv run main.py

设置注释格式

表单管理工具(add_sheet, delete_sheet, copy_sheet)引发CSV文件错误。

工具

工作簿操作

工作表操作

读取数据

写入数据

列操作

搜索

表模式（SQL）

SQL示例：

-- Filter and sort
SELECT name, revenue FROM Sales WHERE status = 'Active' ORDER BY revenue DESC LIMIT 20

-- Cross-sheet JOIN
SELECT o.order_id, c.name FROM Orders o JOIN Customers c ON o.customer_id = c.id

-- Aggregate
SELECT department, COUNT(*) AS n, AVG(salary) AS avg FROM Employees GROUP BY department

-- Mutate
UPDATE Sales SET status = 'Closed' WHERE quarter = 'Q1' AND revenue < 1000
DELETE FROM Logs WHERE date < '2024-01-01'

必须引用带空格的图纸名称： SELECT * FROM "Q1 Sales".

公共参数

每个图纸级工具都接受：

所有行/列索引均为 1-基单元格引用使用A1表示法(A1, $B$2).