@bendyline/gezel-mcp 1.2.5 → 1.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +12 -3
  2. package/dist/server.js +1422 -1025
  3. package/package.json +4 -4
package/README.md CHANGED
@@ -1,13 +1,18 @@
1
1
  # @bendyline/gezel-mcp
2
2
 
3
3
  The [Model Context Protocol](https://modelcontextprotocol.io) server that gives
4
- [gezel](https://github.com/bendyline/gezel) agents their hands.
4
+ gezels, the AI companions in [Gezel](https://github.com/bendyline/gezel), their
5
+ hands.
5
6
 
6
7
  Every tool a gezel can call lives here: memory search and save, workspace file
7
8
  operations, project artifacts, the shared document library, script and
8
9
  Playwright execution, task management, team and project management, image
9
10
  rendering, and history search.
10
11
 
12
+ Gezel runs this server for every gezel's chat. You can also run it from any
13
+ other MCP client, so that client works with your gezels' memories, projects,
14
+ and tasks.
15
+
11
16
  ```bash
12
17
  npm install @bendyline/gezel-mcp
13
18
  ```
@@ -49,6 +54,10 @@ it, then reconnect the server from your MCP client.
49
54
  Run this way, the server acts with your own access, as the `gezel` command
50
55
  does; `GEZEL_PROJECT_ID` picks a default, not a boundary.
51
56
 
57
+ `gezel agent list` (from `@bendyline/gezel-cli`) lists your gezels and their
58
+ ids. The `agent` in that command and in `GEZEL_AGENT_ID` is a historical name:
59
+ both refer to your gezels.
60
+
52
61
  When Gezel starts the server itself, for a gezel's chat, it passes the
53
62
  connection directly: `GEZEL_BASE_URL`, `GEZEL_TOKEN` (a token it mints for that
54
63
  one session, confined to its project unless the gezel coordinates across
@@ -70,8 +79,8 @@ Run the server and call `tools/list` for the authoritative, current inventory.
70
79
  | Subpath | Contents |
71
80
  |---|---|
72
81
  | `@bendyline/gezel-mcp` | Server construction helpers |
73
- | `@bendyline/gezel-mcp/lint-contracts` | Tool-contract linting used by the eval harness |
74
- | `@bendyline/gezel-mcp/dist/server.js` | The stdio entry point. Resolved by string from `packages/service/src/chat/manager.ts` — removing this export makes chat sessions silently run with no tools |
82
+ | `@bendyline/gezel-mcp/lint-contracts` | The exact input and output schemas the built-in tools publish, for checking tool contracts |
83
+ | `@bendyline/gezel-mcp/dist/server.js` | The stdio server itself, also installed as the `gezel-mcp` command. The Gezel service launches this file for every chat, so it stays a supported path |
75
84
 
76
85
  ## Stability
77
86