Local Workbook MCP

MCPAI代理

提供方 McFuzzySquirrel

AI代理 未标注 无需鉴权 社区 / 第三方 Claude DesktopClaudeCursor

一个本地优先的Model Context Protocol服务器,允许AI代理在数据不离开本地机器的情况下分析和写入Excel工作簿。

一句话选型结论

按资料字段整理

Local Workbook MCP 属于AI代理类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude Desktop、Claude、Cursor,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 6 仓库热度,无公开仓库时显示未标注
工具数 7 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量7暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Excel分析C#本地部署本地AI数据隐私MCP协议自然语言处理

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 7 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 7 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Local Workbook MCP当前 7 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方McFuzzySquirrel上游标注的维护方 McFuzzySquirrel
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.2 KB
来自项目仓库与上游目录的原文,未做删改

Excel本地MCP

当地第一 模型上下文协议 该服务器允许AI代理分析和写入Excel工作簿,而无需数据离开您的机器。用自然语言提问,跨表搜索,运行数据透视分析,并通过任何兼容MCP的客户端或附带的web UI更新单元格。



概述

许多团队无法将财务、人力资源或受监管的Excel文件上传到云服务。 Excel本地MCP 通过在您的机器上完全运行MCP服务器来解决这一问题-LLM原因是在您的数据上不接触外部API。

服务器公开了7个直接映射到Excel操作的标准MCP工具。任何兼容MCP的客户端(Claude Desktop、GitHub Copilot、Cursor、您自己的代码)都可以调用这些工具,或者您可以使用附带的DateTimeweb UI或终端代理。```
┌──────────────────────────────────────────────┐
│ Web UI Terminal Agent External MCP │
│ (Blazor) (Spectre.Console) (Claude/etc.) │
└─────────────────────┬────────────────────────┘
│ JSON-RPC over stdio
▼
ExcelMcp.Server
(ModelContextProtocol SDK)
│
ClosedXML
│
Excel workbook (.xlsx)


## 特性

- **隐私第一** --工作簿数据永远不会离开你的机器;LLM通过Ollama或LM Studio在本地运行
- **符合标准的MCP服务器** --建立在 `ModelContextProtocol` v1.1.0 SDK,兼容任何MCP客户端
- **7 Excel工具** --列表结构、搜索、预览、透视分析、写入单元格、写入范围、创建工作表
- **使用自动备份进行回写** --每个突变都会产生一个时间戳 `.xlsx` 保存前备份
- **Blazon网络聊天** --多轮对话、建议查询、会话导出到CSV/Markdown
- **终端代理** --AS/400启发了由Spectre驱动的REPL。控制台和语义内核
- **CLI调试工具** --检查原始MCP工具调用以进行脚本编写和故障排除
- **跨平台** --Windows、Linux、macOS通过。净值10

## 入门指南

### 先决条件

|要求|版本|注释|
|---|---|---|
| .NET SDK |10.0+|构建和运行所需|
|本地LLM服务器|--| 奥拉玛 (推荐)或 LM 工作室 |
|Excel工作簿| `.xlsx` / `.xls` |您自己的文件,或生成示例数据(见下文)|

> \[!提示\]
> 在Linux上,安装 `libgdiplus` 要获得完整的ClosedXML支持,请执行以下操作: `sudo apt install libgdiplus`

### 1.克隆和构建```bash
git clone https://github.com/McFuzzySquirrel/local-workbook-mcp.git
cd local-workbook-mcp
dotnet build

2.生成示例工作簿(可选)```powershell

Creates ProjectTracking.xlsx, EmployeeDirectory.xlsx, BudgetTracker.xlsx in test-data/

pwsh scripts/create-sample-workbooks.ps1

Creates SalesWithPivot.xlsx (includes a pivot table)

pwsh scripts/create-pivot-test-workbook.ps1


### 3.开始你当地的法学硕士

**奥利玛(推荐):**```bash
ollama pull llama3.2
ollama serve
# Runs on http://localhost:11434 — auto-detected by the web UI and run-chatweb.sh

> LM工作室替代方案: 加载任何模型并在上启动本地服务器 http://localhost:1234。web UI将自动检测到它,但是 run-chatweb.sh 只检查Ollama端点——你会看到一个可以安全忽略的警告。

4.启动web UI```bash

Linux / macOS

./run-chatweb.sh

Windows / any platform

dotnet run --project src/ExcelMcp.ChatWeb


打开 `http://localhost:5000`,在侧边栏中选择您的工作簿,然后开始聊天。

### 5.或者启动终端代理```bash
dotnet run --project src/ExcelMcp.SkAgent -- --workbook "path/to/your/workbook.xlsx"

代理运行后的示例查询:```
> What worksheets are in this workbook?
> Show me the first 10 rows of the Tasks sheet
> Search for 'Alice' across all sheets
> What does the SalesPivot pivot table contain?
> Update cell B2 in the Projects sheet to "Completed"


______________________________________________________________________

## MCP工具

服务器向任何MCP客户端公开以下工具。所有工具都接受可选 `workbook_path` 参数;如果省略,服务器将回退到 `EXCEL_MCP_WORKBOOK` 环境变量。

|工具|说明|
|---|---|
| `excel-list-structure` |汇总工作表、命名表、列标题、行数和数据透视表。先叫这个。 |
| `excel-search` |搜索单元格与文本查询匹配的行。支持纸张、表格、限制和区分大小写的过滤器。 |
| `excel-preview-table` |返回工作表或命名表的CSV预览(默认10行)。 |
| `excel-analyze-pivot` |分析透视表结构:行、列、数据和筛选字段以及聚合数据行。 |
| `excel-write-cell` |将值写入单个单元格。保存前自动创建带时间戳的备份。 |
| `excel-write-range` |在一次保存操作中写入多个单元格。自动创建带时间戳的备份。 |
| `excel-create-worksheet` |添加一个新的空白工作表。自动创建带时间戳的备份。 |

______________________________________________________________________

## 与外部MCP客户端一起使用

因为服务器通过stdio使用标准MCP,所以任何兼容的客户端都可以直接使用它。

### 克劳德桌面版

添加到您的Claude Desktop配置文件中:

- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- 窗户: `%APPDATA%/Claude/claude_desktop_config.json````json
{
"mcpServers": {
"excel": {
"command": "/path/to/ExcelMcp.Server",
"args": ["--workbook", "/path/to/your/workbook.xlsx"]
}
}
}

已准备好合并的代码段位于 mcp配置/claude_desktop_configure.json.

光标

合并 ~/.cursor/mcp.json --看 mcp配置/cursor_mcp_config json.

GitHub副本/VS代码代理模式

创建 .vscode/mcp.json 在您的工作区中,指向服务器可执行文件。

> [!注意]
> 服务器二进制文件的构建目的是 src/ExcelMcp.Server/bin/Debug/net10.0/ExcelMcp.Server (或 .exe 在Windows上)。使用 scripts/package-server.ps1 生成自包含的可分发脚本。


命令行客户端

ExcelMcp.Client 是一个轻量级的CLI,用于直接调用MCP工具。可用于脚本编写、冒烟测试和调试工具有效负载。```bash
export EXCEL_MCP_SERVER="src/ExcelMcp.Server/bin/Debug/net10.0/ExcelMcp.Server"
export EXCEL_MCP_WORKBOOK="test-data/ProjectTracking.xlsx"

Available commands

dotnet run --project src/ExcelMcp.Client -- list
dotnet run --project src/ExcelMcp.Client -- preview Tasks --rows 5
dotnet run --project src/ExcelMcp.Client -- search "High priority"
dotnet run --project src/ExcelMcp.Client -- analyze-pivot SalesPivot
dotnet run --project src/ExcelMcp.Client -- write-cell --sheet Tasks --cell G1 --value "Done"
dotnet run --project src/ExcelMcp.Client -- write-range --sheet Tasks --range A10:B10 \
--data '[{"cellAddress":"A10","value":"New Task"},{"cellAddress":"B10","value":"Open"}]'
dotnet run --project src/ExcelMcp.Client -- create-worksheet "Summary"


涵盖所有4个示例工作簿的自动烟雾测试脚本位于 脚本/测试/手动测试cli.sh (35/35通过)。

______________________________________________________________________

## 配置

### Web用户界面

中的关键设置 `src/ExcelMcp.ChatWeb/appsettings.json`:```json
{
"SemanticKernel": {
"BaseUrl": "http://localhost:11434/v1",
"Model": "llama3.2",
"ApiKey": "not-needed-for-local",
"TimeoutSeconds": 480
},
"ExcelMcp": {
"ServerPath": "src/ExcelMcp.Server/bin/Debug/net10.0/ExcelMcp.Server"
},
"Conversation": {
"MaxContextTurns": 5,
"MaxResponseLength": 10000
}
}

这 BaseUrl 自动检测:Ollama(localhost:11434)首先尝试,然后是LM Studio(localhost:1234).

覆盖开发 appsettings.Development.json.

终端代理

通过环境变量进行配置:```bash

Ollama (default — auto-detected)

export LLM_BASE_URL="http://localhost:11434/v1"
export LLM_MODEL_ID="llama3.2"

or LM Studio

export LLM_BASE_URL="http://localhost:1234/v1"
export LLM_MODEL_ID="local-model"
export EXCEL_MCP_WORKBOOK="/path/to/workbook.xlsx"


______________________________________________________________________

## 测试

**57次用户验收测试** 涵盖所有4个示例工作簿和写入操作:```bash
dotnet test tests/ExcelMcp.UAT/ExcelMcp.UAT.csproj

手动测试检查表 对于web UI(43个步骤): scripts/tests/manual-test-chatweb.md

自动化CLI烟雾测试 (35个自动验证+2个手动验证跳过):```bash
./scripts/tests/manual-test-cli.sh

Filter to a single workbook group:

./scripts/tests/manual-test-cli.sh --workbook ProjectTracking


______________________________________________________________________

## 建筑

该系统遵循 **六角形/端口和适配器** 适用于MCP的模式。服务器是一个孤立的进程;UI和代理层仅通过MCP协议与其通信。```
src/
├── ExcelMcp.Server/       # MCP server — 7 tool handlers, ClosedXML backend
├── ExcelMcp.Contracts/    # Shared sealed-record DTOs
├── ExcelMcp.ChatWeb/      # Blazor Server web UI + Semantic Kernel orchestration
├── ExcelMcp.SkAgent/      # Terminal REPL agent (Spectre.Console + SK)
└── ExcelMcp.Client/       # CLI debug and scripting client

看 docs/Architecture.md 查看完整的序列图和组件描述。

> [!注意]
> UI层从不导入 ExcelMcp.Server 直接。所有数据都通过JSON-RPC工具调用流动,这意味着相同的服务器二进制文件对web UI、终端代理、Claude Desktop和Cursor的工作方式相同。


资源

  • 模型上下文协议规范
  • 模型上下文协议。NET SDK
  • Microsoft语义内核文档
  • 已关闭XML --Excel处理库
  • LM 工作室 · 奥拉玛 --本地LLM选项
  • docs/UserGuide.md --详细的设置和使用指南
  • docs/FutureFeatures.md --路线图

> 这个项目源于一个简单的问题:“我可以在不将电子表格发送到云端的情况下与它聊天吗?”这里的一切都是一个学习实验——在开放的环境中构建,共享,以防对其他人有用。

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Local Workbook MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Local Workbook MCP 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Local Workbook MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Local Workbook MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Local Workbook MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Local Workbook MCP 能提供哪些能力?

资料显示约 7 个工具;能力标签包括 本地AI、C#、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。