Zellij MCP 076aaa0d

MCP开发工具

提供方 mustardamus · 包名 zellij-mcp

开发工具 stdio · 本地进程 会话登录 社区 / 第三方 Claude
查看接入方式

zellij-mcp是一个MCP服务器,将Zellij终端多路复用器的操作作为工具暴露给AI编码代理,支持创建标签页、打开窗格、运行命令等操作,同时默认保持用户当前焦点。

一句话选型结论

按资料字段整理

Zellij MCP 076aaa0d 属于开发工具类 MCP 服务器,stdio · 本地进程,会话登录,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权会话登录 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 20 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量20暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

终端多路复用TypeScript本地部署AI编码辅助开发工具命令行工具自动化

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
npx zellij-mcp

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 20 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 20 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zellij MCP 076aaa0d当前 20 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方mustardamus上游标注的维护方 mustardamus
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时zellij-mcp · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.6 KB
来自项目仓库与上游目录的原文,未做删改

zellij-mcp

An MCP server that exposes Zellij terminal multiplexer operations as tools for AI coding agents. Create tabs, open panes, run commands, read terminal output, and open files in your $EDITOR -- all from an AI assistant.

Tools map mostly 1:1 to Zellij CLI actions, but improve on them by preserving the user's focus by default -- when an agent creates a tab or runs a command, it won't yank your view away from what you're working on.

Usage

Claude Code```bash

claude mcp add zellij-mcp -- npx zellij-mcp


Or in `.claude/settings.json`:```json
{
  "mcpServers": {
    "zellij-mcp": {
      "command": "npx",
      "args": ["zellij-mcp"]
    }
  }
}

opencode

In opencode.json:```json
{
"mcp": {
"zellij-mcp": {
"type": "local",
"command": ["npx", "zellij-mcp"]
}
}
}


### Other MCP clients

zellij-mcp uses stdio transport. Point your client at:```bash
npx zellij-mcp

The server automatically detects the current Zellij session. Set ZELLIJ_MCP_SESSION_NAME to override the target session.

Environment Variables

ZELLIJ_MCP_SESSION_NAME

Override the Zellij session name to target with all commands. When unset, the server automatically detects the current session via Zellij's own ZELLIJ_SESSION_NAME environment variable (set in every pane). Falls back to zellij-mcp if neither is available.

ZELLIJ_MCP_DELAY_MS

Post-action delay in milliseconds. After each Zellij action, the server waits this long for the Zellij server to process the action before sending the next command. Defaults to 60. Increase for slow environments (e.g. SSH remotes).

ZELLIJ_MCP_DUMP_DIR

Directory for temporary screen dump files created by read_pane and read_pane_full. Defaults to /tmp. Files are cleaned up automatically after reading.

Focus Preservation

By default, several tools in zellij-mcp preserve the user's current focus instead of switching to the newly created tab or pane. This differs from raw Zellij behavior, where actions like new-tab or new-pane always move focus to the new element.

The rationale: when an AI agent creates a background tab for a dev server or spawns a pane to run tests, it shouldn't yank the user's view away from what they're working on.

Affected tools

Tool Zellij default zellij-mcp default Override
new_tab Switches focus to new tab Focus stays on current tab switch_to: true
new_pane Switches focus to new pane Focus stays on current pane switch_to: true
run_command Switches focus to new pane Focus stays on current pane switch_to: true
rename_tab Operates on focused tab only Can target any tab by name target: "tab-name"
close_tab Operates on focused tab only Can target any tab by name target: "tab-name"

edit_file is not focus-preserving — it always switches focus to the editor pane, since the user needs to interact with it.

How it works

When focus preservation is active, the tool:

  1. Calls dump-layout to find the currently focused tab
  2. Performs the action (which may move focus as a side effect)
  3. Calls go-to-tab-name to restore focus to the original tab

Examples

These are the default behaviors — the agent will preserve focus automatically:

> "Create a new tab called server"

To override and switch focus, tell the agent explicitly:

> "Create a new tab called server and switch to it"

Tools

Session

zellij_list_sessions

List all active Zellij sessions. Docs```bash
zellij list-sessions --short --no-formatting


#### `zellij_query_tab_names`

Get all tab names in the current session. Returns one tab name per line. Docs```bash
zellij --session zellij-mcp action query-tab-names

zellij_dump_layout

Dump the full current layout of the session to understand the workspace structure including tabs, panes, and their arrangement. Docs```bash
zellij --session zellij-mcp action dump-layout


#### `zellij_list_clients`

List all clients connected to the current session, their focused pane id, and their running command. Docs```bash
zellij --session zellij-mcp action list-clients

Tabs

zellij_go_to_tab

Switch to a named tab in the session. Use zellij_query_tab_names first to discover available tab names. Docs

Parameter Required Description
name yes The name of the tab to switch to (e.g. "editor", "server", "git").
zellij --session zellij-mcp action go-to-tab-name <name>

zellij_new_tab

Create a new tab in the session with an optional name and layout. By default, focus stays on the current tab. Docs

Parameter Required Description
name no Name for the new tab. If omitted, Zellij assigns a default name.
layout no Path to a layout file to use for the new tab.
cwd no Working directory for the new tab.
switch_to no If true, switch focus to the new tab. Defaults to false.
zellij --session zellij-mcp action new-tab [--name <name>] [--layout <layout>] [--cwd <cwd>]

zellij_rename_tab

Rename a tab in the session. If target is provided, renames that specific tab without changing focus. If omitted, renames the currently focused tab. Docs

Parameter Required Description
name yes The new name for the tab.
target no The current name of the tab to rename. If omitted, renames the focused tab.
zellij --session zellij-mcp action rename-tab <name>

zellij_close_tab

Close a tab in the session. If target is provided, closes that specific tab and restores focus to the original tab. If omitted, closes the currently focused tab. Use with caution -- this is destructive and cannot be undone. Docs

Parameter Required Description
target no The name of the tab to close. If omitted, closes the focused tab.
zellij --session zellij-mcp action close-tab

Terminal I/O

zellij_write_to_pane

Send keystrokes to the currently focused pane. This is raw keystroke injection -- characters are typed exactly as provided. By default, a carriage return (Enter key, char 13) is sent after the characters to execute them. Set enter to false to send only the raw characters without a trailing Enter. Docs

Parameter Required Description
chars yes The characters to type into the focused pane.
enter no If true (default), send a carriage return (char 13) after the characters. Set to false to skip the trailing Enter.
zellij --session zellij-mcp action write-chars <chars>
zellij --session zellij-mcp action write 13        # sent automatically unless enter=false

zellij_read_pane

Capture the visible terminal output of the currently focused pane. Writes to a temporary file in ZELLIJ_MCP_DUMP_DIR (defaults to /tmp), reads it, then cleans up. Docs```bash
zellij --session zellij-mcp action dump-screen <path>


#### `zellij_read_pane_full`

Capture the full scrollback buffer of the currently focused pane. Same as `read_pane` but includes all history that has scrolled off screen. Output can be very large for long-running processes. Docs```bash
zellij --session zellij-mcp action dump-screen --full &lt;path&gt;

zellij_run_command

Run a command in a new Zellij pane. Always creates a new pane -- does not run in the currently focused pane. By default, focus stays on the current pane. Docs

Parameter Required Description
command yes The command and its arguments as an array (e.g. [&quot;npm&quot;, &quot;test&quot;]).
floating no If true, run in a floating pane instead of a tiled pane.
name no Optional name for the new pane.
close_on_exit no If true, the pane closes automatically when the command finishes.
cwd no Working directory for the command.
switch_to no If true, move focus to the new command pane. Defaults to false.
zellij --session zellij-mcp run [--floating] [--name &lt;name&gt;] [--close-on-exit] [--cwd &lt;cwd&gt;] -- &lt;command...&gt;

Panes

zellij_new_pane

Open a new pane in the currently focused tab. By default, opens a tiled pane. By default, focus stays on the current pane. Docs

Parameter Required Description
floating no If true, open a floating pane instead of a tiled pane.
name no Optional name for the new pane.
direction no Direction to place the new tiled pane relative to the focused pane (down, right, up, left). Ignored for floating panes.
cwd no Working directory for the new pane.
command no Optional command and arguments to run in the new pane (e.g. [&quot;npm&quot;, &quot;test&quot;]).
switch_to no If true, move focus to the new pane. Defaults to false.
zellij --session zellij-mcp action new-pane [--floating] [--name &lt;name&gt;] [--direction &lt;direction&gt;] [--cwd &lt;cwd&gt;] [-- &lt;command...&gt;]

zellij_close_pane

Close the currently focused pane. Any process running in the pane will be terminated. Focus moves to an adjacent pane. Use with caution -- this is destructive and cannot be undone. Docs```bash
zellij --session zellij-mcp action close-pane


#### `zellij_focus_pane`

Move focus to an adjacent pane in the given direction. Only moves focus between tiled panes. If there is no pane in the specified direction, focus does not change. Docs

| Parameter | Required | Description |
|-----------|----------|-------------|
| `direction` | yes | The direction to move focus (up, down, left, right). |
```bash
zellij --session zellij-mcp action move-focus &lt;direction&gt;

zellij_toggle_floating_panes

Show or hide all floating panes in the currently focused tab. This is a toggle -- calling it twice returns to the original state. Docs```bash
zellij --session zellij-mcp action toggle-floating-panes


#### `zellij_toggle_fullscreen`

Toggle fullscreen mode on the currently focused pane. When active, the pane expands to fill the entire tab area. Calling it again restores the original layout. Focus remains on the same pane. Docs```bash
zellij --session zellij-mcp action toggle-fullscreen

zellij_rename_pane

Rename the currently focused pane. The name appears in the pane frame/border. Focus does not change. Docs

Parameter Required Description
name yes The new name for the currently focused pane.
zellij --session zellij-mcp action rename-pane &lt;name&gt;

zellij_resize_pane

Resize the currently focused pane in the given direction. The pane grows in the specified direction, shrinking adjacent panes. Only works for tiled panes. Focus does not change. Docs

Parameter Required Description
direction yes The direction to grow the pane (up, down, left, right).
zellij --session zellij-mcp action resize &lt;direction&gt;

Editor

zellij_edit_file

Open a file in the user's $EDITOR (e.g. Helix, Vim, Nano) in a new Zellij pane. Focus moves to the newly created editor pane. The pane closes automatically when the user exits the editor. This opens the file for the human user to edit interactively -- it does not return file contents. Docs

Parameter Required Description
file yes The path to the file to open. Can be absolute or relative to the session's working directory.
floating no If true, open the editor in a floating pane instead of a tiled pane.
line_number no Line number to jump to when opening the file (1-indexed).
direction no Direction to place the new tiled pane relative to the focused pane (down, right, up, left). Ignored for floating panes.
cwd no Working directory for the editor pane. Useful when the file path is relative.
zellij --session zellij-mcp action edit &lt;file&gt; [--floating] [--line-number &lt;n&gt;] [--direction &lt;direction&gt;] [--cwd &lt;cwd&gt;]

Development

Prerequisites

  • Bun - JavaScript runtime and package manager
  • opencode - AI coding agent for the dev layout
  • Helix - terminal text editor for the dev layout
  • lazygit - terminal Git UI for the dev layout

Setup```bash

git clone https://github.com/mustardamus/zellij-mcp.git
cd zellij-mcp
bun install
bun run setup # downloads the latest Zellij binary for the current architecture


Start a Zellij session with four tabs - agent, editor, server, and git:```bash
bun run dev:zellij

Or run the MCP server standalone (with watch mode):bash bun run dev

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Zellij MCP 076aaa0d 怎么安装?

在客户端按下面的安装命令接入:npx zellij-mcp。对应的包名是 zellij-mcp。装完在客户端配置里引用同一个包或端点。

Zellij MCP 076aaa0d 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Zellij MCP 076aaa0d 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Zellij MCP 076aaa0d 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Zellij MCP 076aaa0d 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Zellij MCP 076aaa0d 能提供哪些能力?

资料显示约 20 个工具;能力标签包括 开发工具、TypeScript、Claude、命令行工具。具体工具清单以官方文档为准。

Zellij MCP 076aaa0d 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Zellij MCP 076aaa0d 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。