# graph-excel-mcp 中文文档

规范地址：https://npmcn.com/package/graph-excel-mcp/

版本：0\.4\.0
npm 元数据更新时间：2026-11-03T18:09:14.319Z
中文译文更新时间：2026-11-03T19:01:48.282Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/graph-excel-mcp
原文对照：https://npmcn.com/package/graph-excel-mcp/?lang=original
项目主页：https://github.com/mickey-ichi/graph-excel-mcp#readme
源码仓库：https://github.com/mickey-ichi/graph-excel-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：41.7 kB，8 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-11-03T13:37:13.388Z
- 最新版本发布：2026-11-03T18:09:14.014Z
- 已发布版本数：3（近 12 个月 3 个）

## 中文简介

MCP服务器通过microsoftgraph在SharePoint/OneDrive上读取和编辑Excel工作簿：基本检查写入，回读验证，填充。零依赖关系。

## 安装

```sh
npm install graph-excel-mcp
```

也可以使用：`pnpm add graph-excel-mcp`、`yarn add graph-excel-mcp`、`bun add graph-excel-mcp`

## README

# graph-excel-mcp

MCP服务器，通过microsoftgraph在SharePoint， OneDrive或Teams上阅读和编辑Excel工作簿，无需浏览器。它是用TypeScript编写的，没有运行时依赖，运行在Node 18或更高版本上。

它是为几个人同时编辑的工作簿构建的：

-   每次写作都是从演练开始的。
-   在写入之前，它根据您读取的版本检查单元格的当前内容，因此它不会覆盖其他人的编辑。
-   写入后，它将读取单元格以确认更改。

## 安装

**Claude代码/任何MCP主机（stdio）：**

```bash
claude mcp add --scope user graph-excel -- npx -y graph-excel-mcp
```

```json
{ "mcpServers": { "graph-excel": { "command": "npx", "args": ["-y", "graph-excel-mcp"] } } }
```

**克劳德桌面扩展：** 下载 `graph-excel-mcp-<version>.mcpb` 从 [最新版本](https://github.com/mickey-ichi/graph-excel-mcp/releases/latest) 然后打开它。

**Claude插件（Cowork, Claude Code）：** 安装 `plugin/` 这个回购的文件夹。它包含服务器和a `graph-excel` 技能。

## 登录

调用 `login_status` 工具，或运行 `npx graph-excel-mcp login`，然后输入显示的代码 [https://login.microsoft.com/device](https://login.microsoft.com/device)． 刷新令牌保存在 `~/.graph-excel/token.json` 模式为600。集 `GRAPH_EXCEL_HOME` 把它放在别的地方。

登录使用带有委托作用域的Microsoft Graph PowerShell公共客户端 `Files.ReadWrite.All`，所以你不需要注册应用程序。如果你的租户阻止用户同意，管理员必须批准该客户端一次。

## 工作簿的别名

您可以添加别名，而不是每次都粘贴SharePoint URL `~/.graph-excel/workbooks.json` (见 `workbooks.example.json`）. 这个 `resolve` 工具返回 `driveId` 和 `itemId` 你需要一个别名。

## 工具

| 工具 | 它是做什么的 |
| --- | --- |
| `login_status` | 检查令牌，或启动设备代码登录 |
| `resolve` | 返回驱动器/项目id，最后修改，以及使用范围的工作表 |
| `read_range` | 返回值加a `sha256:` 每个单元格散列，并根据请求填充 |
| `write_values` | 使用基本检查(`expected`)和回读验证 |
| `append_update` | 在单元格现有文本下添加或替换“-----update-----”部分，保持原始部分字节相同，并可以用颜色填充行 |
| `set_fill` | 设置或清除单个批处理中一个或多个区域的填充颜色 |

## 笔记

-   每个调用都在工作簿会话中运行。即使应用了写操作，大型工作簿上的无会话调用也会因504而超时。
-   换行被发送为 `\n`， Excel将其存储为 `\r\n`． 如果你写 `\r\n` 直接地，细胞最终变成了流浪狗 `_x000D_`。

## 发展

开发需要Node 22.18或更高版本，它运行 `.ts` 直接来源。

| 命令 | 它是做什么的 |
| --- | --- |
| `npm run mcp` / `npm run login` | 运行服务器或终端登录 `src/` |
| `npm run typecheck` | 运行 `tsc` 在严格模式下，没有发射 |
| `npm test` | 运行离线测试：范围解析、更新组合和MCP握手 `src/` 和 `dist/` |
| `npm run build` | 编译 `src/` 来 `dist/`，也就是npm `.mcpb` 然后插件运行 |
| `npm run pack` | 构建，然后写入 `build/*.mcpb` (gitignored)和 `plugin/` (承诺) |

布局:

| 路径 | 内容 |
| --- | --- |
| `src/graph.ts` | Auth和图形客户端 |
| `src/excel.ts` | 工作簿操作 |
| `src/mcp.ts` | 工具和JSON-RPC服务器 |
| `src/cli.ts` | 入口 |

## 释放

撞 `version` 在 `package.json`、运行 `npm run pack`，提交，然后推入匹配的标签：

```bash
git tag v0.3.1 && git push origin v0.3.1
```

这个 `Publish` 工作流运行测试，通过可信发布（没有令牌或OTP；附上出处）发布到npm，并使用 `.mcpb` 附呈。

## 许可证

麻省理工学院

## 常见问题

### graph-excel-mcp 是什么？

MCP服务器通过microsoftgraph在SharePoint/OneDrive上读取和编辑Excel工作簿：基本检查写入，回读验证，填充。零依赖关系。

### 如何安装 graph-excel-mcp？

在项目目录运行 npm install graph-excel-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 graph-excel-mcp，可以用 npx graph-excel-mcp 直接运行。

### graph-excel-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/graph-excel-mcp 是否存在。

### graph-excel-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### graph-excel-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### graph-excel-mcp 可以商用吗？

graph-excel-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### graph-excel-mcp 还在维护吗？

最新版本 0\.4\.0 发布于 2026/11/04（今天）；至今共发布 3 个版本，其中过去 12 个月发布了 3 个；首次发布于 2026/11/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。