# @bendyline/gezel-mcp 中文文档

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

版本：1\.2\.13
npm 元数据更新时间：2026-11-05T04:02:01.407Z
中文译文更新时间：2026-11-07T23:30:04.637Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：784 kB，13 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.0\.0
- 运行依赖：5 个
- 首次发布：2026-08-11T14:00:40.146Z
- 最新版本发布：2026-11-05T04:02:01.041Z
- 近 30 天下载量：2041（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 26 个）

## 中文简介

Gezel的"模型背景协议"服务器:让Gezels和其他MCP客户端访问内存,工作空间文件,文物,任务,以及团队工具.

## 安装

```sh
npm install @bendyline/gezel-mcp
```

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

## README

# @bendyline/gezel-mcp (英语)

这个 [示范背景协议](https://modelcontextprotocol.io/) 服务器 gezels, AI的同伴们在 [格泽尔](https://github.com/bendyline/gezel)他们 手给我.

每个 Gezel 工具都可以叫这里的生活: 内存搜索和保存, 工作空间文件 操作、项目文物、共享文件库、脚本 Playwright 执行、任务管理、团队和项目管理、图像 渲染和历史搜索.

Gezel每一次聊天都会运行这个服务器. 还给其他AI应用程序 (Claude Code, Codex, Cursor, Claude Desktop, VS 代码) Gezel的一套小代码 工具;见 [其它AI应用程序](https://npmcn.com/package/%40bendyline/gezel-mcp/#readme-for-other-ai-apps)。 。 。 .

```bash
npm install @bendyline/gezel-mcp
```

## 其它AI应用程序

`gezel-mcp --harness <client>` (单位:千美元)`claude-code`, (中文(简体) ), `claude-desktop`, (中文(简体) ), `codex`, (中文(简体) ), `cursor` 或者说 `vscode`)给出一个已经有自己的文件, shell 和 只有Gezel有的网页工具:搜索它工作的文件夹(包括 办公室文件文本、个人共享的图书馆、记忆和 知识目录、办公室文件作为下标、图像描述和 和记忆。 共有九道工具,全程都有绝对路径.

从Gezel(定居) 整合,或 `gezel mcp install <app>`, (中文(简体) ), 它为您撰写了应用程序条目 。 通过手,运行服务器 在节点24或 稍后从您工作的文件夹中 :

```json
{
  "mcpServers": {
    "gezel": {
      "command": "npx",
      "args": ["-y", "@bendyline/gezel-mcp", "--harness", "claude-code"]
    }
  }
}
```

服务器将 Gezel 项目绑定在应用报告( MCP root) 文件夹中, 或者说 `--folder <path>`,或其工作目录; `--project <id>` 一个名字 绝对的。 它读到所有者证书 从 `~/.gezel/runtime/` 一次和一次 交易它作为一种标志 限制在项目和选择的人 在Gezel制造的,所以应用的模型 从来没有与人的全部访问。 若为 Gezel没有运行,每个工具都这么说,而不是服务器退出.

## 整个地表,有你自己的通道

无 `--harness` 服务器提供gezel的每一个工具, 与您一起行动 自我访问,作为 `gezel` 命令确实如此。 它能讲Stdio,所以任何MCP客户都可以 运行它。 随着Gezel在同一台电脑上运行:

```json
{
  "mcpServers": {
    "gezel": {
      "command": "npx",
      "args": ["-y", "@bendyline/gezel-mcp"],
      "env": {
        "GEZEL_AGENT_ID": "<a gezel id from `gezel agent list`>",
        "GEZEL_PROJECT_ID": "default"
      }
    }
  }
}
```

没有可以配置的地址、密码或证书 。 服务器是 薄的前端,它召回 运行中的Gezel服务,发现它 它自己的: Gezel 选择它的端口、 它的登录符和它的 TLS 证书 : 每一次发射并写给 `~/.gezel/runtime/` (单位:千美元)`port`, (中文(简体) ), `auth-token`, (中文(简体) ), `cert.pem`只有你才能读 服务器在启动时读取它们 跟随 Gezel 进行重启, 因此一个长寿的 MCP 客户端在之后继续工作 格泽尔最新消息 如果客户端启动服务器时 Gezel 不运行, 它 带消息退出以打开 Gezel 应用程序或运行 `gezel start`; 开始 然后从您的 MCP 客户端重新连接服务器 .

| 变量 |  |
| --- | --- |
| `GEZEL_AGENT_ID` | Gezel工具的作用是:它们搜索和保存它们的记忆,它们看到它们的任务. |
| `GEZEL_PROJECT_ID` | 项目工具在调用名称时使用。 默认 `default`。 。 。 . |
| `GEZEL_HOME` | 格泽尔的家 `~/.gezel`。 。 。 . |

运行此方式,服务器使用您自己的访问权限作为 `gezel` 命令 已经; `GEZEL_PROJECT_ID` 选择默认而非边界.

`gezel agent list` (从) `@bendyline/gezel-cli`列出你的宝石及其 编号。 这个 `agent` 在命令中以及在命令中 `GEZEL_AGENT_ID` 是一个历史名称: 都提到你的果酱了.

当Gezel启动服务器时,为了Gezel的聊天,它通过 直接连接 : `GEZEL_BASE_URL`, (中文(简体) ), `GEZEL_TOKEN` (一个象征它薄荷用于此) 一会,限于其项目,除非胶囊座标横跨 (项目)和 `GEZEL_CERT_PATH` (单位:千美元) `runtime/cert.pem` 那个信使的服务是用的。 设置 `GEZEL_BASE_URL` 自己把望向关闭, 并保持所有三个电流的重启 那就由你决定了.

## 工具类别

记忆 工作空间文件 工程文物 共享文件 脚本和 · 团队和项目管理 任务 / 用户问题 / 历史搜索 / 图像渲染 .

运行服务器并呼叫 `tools/list` 用于权威的当前清单.

## 入境点

| 子路径 | 目录 |
| --- | --- |
| `@bendyline/gezel-mcp` | 服务器构建助手 |
| `@bendyline/gezel-mcp/lint-contracts` | 内置工具公布的确切投入和产出计划,用于检查工具合同 |
| `@bendyline/gezel-mcp/dist/server.js` | Stdio 服务器本身, 也安装为 `gezel-mcp` 命令。 Gezel 服务为每次聊天启动此文件, 因此它会保留一个支持的路径 |

## 稳定

公众API 在semver下. 工具名称和参数计划是其中的一部分 合同:删除一个工具或缩小一个参数是一个突破性变化.

麻省理工学院

## 常见问题

### @bendyline/gezel-mcp 是什么？

Gezel的"模型背景协议"服务器:让Gezels和其他MCP客户端访问内存,工作空间文件,文物,任务,以及团队工具\.

### 如何安装 @bendyline/gezel-mcp？

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

### @bendyline/gezel-mcp 支持 TypeScript 吗？

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

### @bendyline/gezel-mcp 支持 ESM 还是 CommonJS？

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

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

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

### @bendyline/gezel-mcp 可以商用吗？

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

### @bendyline/gezel-mcp 的下载量有多少？

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

### @bendyline/gezel-mcp 还在维护吗？

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