@bendyline/gezel-mcp

中文文档
1.2.13发布于 2026/11/05MITTypeScriptES Module构建来源已验证近 30 天下载 2041

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

中文使用文档
文档目录5 节
  1. 其它AI应用程序
  2. 整个地表,有你自己的通道
  3. 工具类别
  4. 入境点
  5. 稳定

@bendyline/gezel-mcp (英语)

这个 示范背景协议 服务器 gezels, AI的同伴们在 格泽尔他们 手给我.

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

Gezel每一次聊天都会运行这个服务器. 还给其他AI应用程序 (Claude Code, Codex, Cursor, Claude Desktop, VS 代码) Gezel的一套小代码 工具;见 其它AI应用程序。 。 。 .

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或 稍后从您工作的文件夹中 :

{
  "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在同一台电脑上运行:

{
  "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_IDGezel工具的作用是:它们搜索和保存它们的记忆,它们看到它们的任务.
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.jsStdio 服务器本身, 也安装为 gezel-mcp 命令。 Gezel 服务为每次聊天启动此文件, 因此它会保留一个支持的路径

稳定

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

麻省理工学院

版本与发布记录

@bendyline/gezel-mcp 共发布 26 个版本,首次发布于 2026/08/11;过去 12 个月发布了 26 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.2.13latest2026/11/053 天前
1.2.122026/11/044 天前
1.2.112026/10/2811 天前
1.2.102026/10/2712 天前
1.2.92026/10/2712 天前
1.2.82026/10/2415 天前

关于 @bendyline/gezel-mcp 的常见问题

@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 和提交记录判断。