# @adeu/mcp-server 中文文档

规范地址：https://npmcn.com/package/%40adeu/mcp-server/

版本：3\.1\.0
npm 元数据更新时间：2026-11-05T13:35:37.968Z
中文译文更新时间：2026-11-06T15:45:14.908Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40adeu/mcp-server
原文对照：https://npmcn.com/package/%40adeu/mcp-server/?lang=original
项目主页：https://github.com/dealfluence/adeu#readme
源码仓库：https://github.com/dealfluence/adeu

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

- 包体积（解压后）：1.3 MB，84 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.0\.0
- 运行依赖：4 个
- 首次发布：2026-05-11T11:31:13.699Z
- 最新版本发布：2026-11-05T13:35:37.565Z
- 近 30 天下载量：2853（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：60（近 12 个月 60 个）

## 中文简介

[![GitHub Repo stars](https://img.shields.io/github/stars/dealfluence/adeu?style=social)](https://github.com/dealfluence/adeu) [![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io/) \[里肯斯:MIT\](ht)

## 安装

```sh
npm install @adeu/mcp-server
```

也可以使用：`pnpm add @adeu/mcp-server`、`yarn add @adeu/mcp-server`、`bun add @adeu/mcp-server`

## README

# @ adeu/ mcp- 服务器

[![GitHub Repo stars](https://img.shields.io/github/stars/dealfluence/adeu?style=social)](https://github.com/dealfluence/adeu) [![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io/) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

**原生 Microsoft Word track 更改 AI 代理**

`@adeu/mcp-server` 是一个独立的节点.js [示范背景协议(MCP)](https://modelcontextprotocol.io/) 用于 Microsoft Word 文档的“虚拟 DOM” 服务器。 它为AI代理(如克洛德)提供了安全阅读,编辑和消毒的工具 `.docx` 文档,而不销毁基础格式或复杂的 XML.

此软件包提供了与 Python 完全相同的引擎 `adeu` CLI, 但完全通过Node.js执行, 使它适合Python不可用或不理想的环境 .

## 使用 MCP 客户端

您可以使用此服务器直接添加到您的 MCP 客户端( 如 Claude 桌面、 光标或 Windsurf) `npx`。 。 。 .

在您的 MCP 配置文件中添加以下内容( Name`claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "adeu-node": {
      "command": "npx",
      "args": ["-y", "@adeu/mcp-server"]
    }
  }
}
```

## 曝光工具

一旦连接,你的AI代理将访问以下工具.

### 文件工具

-   `read_docx`: 读取一个 DOCX 文件, 并用内置 CriticMarkup 返回 LLM 方便文本(`{++inserted++}`, (中文(简体) ), `{--deleted--}`用于跟踪修改和评论。 支持 pagination, 结构图解, 形成字段发现(`mode="fields"`),和语义附录取出.
-   `process_document_batch`: 应用一组搜索和替换文本修改,形成字段编辑(`set_field`),表格编辑和对文档的注释答复。 将 LLM 的编辑转换为完全格式化的本地文字轨迹更改 .
-   `accept_all_changes`: 接受所有有轨电车的更改,以产生最终确定的清洁文件. `remove_comments` (默认) `true`)也删除每个注释;通过 `remove_comments=false` 留着他们。 删除的评论由ID和作者报告.
-   `diff_docx_files`:比较两个DOCX文件,并返回其文本内容的一个统一的子单词diff.
-   `finalize_document`:通过应用本地的OOXML只读锁定和深层元数据消毒来编写文档供签名.

### 电子邮件工具

这需要经过认证的Adeu Cloud会议(见下文Cloud工具).

-   `search_and_fetch_emails`:通过Adeu Cloud后端搜索用户的活电子邮件收件箱并返回匹配的消息.
-   `create_email_draft`: 在用户本地草稿框( Outlook Drafts 或 Gmail Drafts) 中创建电子邮件草稿 .
-   `list_available_mailboxes`:列出所有个人和共享/授权的邮箱,经认证的用户可在每个链接的提供者账户中访问,包括每个邮箱的地址,显示名称,以及自动处理设置.

### 云工具

-   `login_to_adeu_cloud`:将用户登录到Adeu Cloud,打开浏览器窗口进行SSO认证.
-   `logout_of_adeu_cloud`:日志出自"阿德乌"云后端.

## 文档和支持

有关建筑细节、及时建议和项目章程,请访问 [主 Adeu 存储器](https://github.com/dealfluence/adeu) 或者我们 [网站](https://adeu.ai/)。 。 。 .

* * *

## 开发 运行本 注: 工作空间链接陷阱

> \[尖叫声\] **节点 MCP:承诺源修补不是运行中修补.** `dist/` 正在被 gitignor , 服务器运行编译的捆绑 。 任何变更后 `node/packages/core` 或者说 `mcp-server`数字 :
> 
> 1.  **重新连接依赖性 :** `cd node && npm install` (联系 `@adeu/core` 在工作空间中;一个被复制的——而不是相链接的——核心是"fix didn't take"的# 1原因.
> 2.  **重建工作空间 :** `npm run build` (核心建于 mcp- server 之前; 确认) `core/dist` 时间戳已更新).
> 3.  **校验 :** 检查是否成功( 自动运行后建, 或者可以手动运行) `npm run build:verify` 下级 `packages/mcp-server`) (中文(简体) ).
> 4.  **重新启动 MCP 服务器 :** 重新启动 MCP 服务器并在客户端中重新连接以冲出任何缓存进程状态 .
> 5.  **确认盖章 :** 验证运行服务器中的构建章( 通过 `server_info` 或启动日志)匹配您的已建 git Head.

## 常见问题

### @adeu/mcp-server 是什么？

\[里肯斯:MIT\]\(ht\)

### 如何安装 @adeu/mcp-server？

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

### @adeu/mcp-server 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @adeu/mcp-server 支持 ESM 还是 CommonJS？

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

### @adeu/mcp-server 需要什么版本的 Node\.js？

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

### @adeu/mcp-server 可以商用吗？

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

### @adeu/mcp-server 的下载量有多少？

根据 npm 官方下载统计，@adeu/mcp-server 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,853 次，日均约 95 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @adeu/mcp-server 还在维护吗？

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