Zellij MCP Server

单元格 MCP 服务器

用于管理Zellij终端工作区会话的综合模型上下文协议（MCP）服务器。此服务器为会话管理、窗格操作、选项卡控件、插件集成、布局管理和高级LLM完成检测提供了广泛的工具。

特性

🏗️ 会话管理

通过高级操作完成会话生命周期管理：

• 基本操作：列出、创建、附加、终止、删除会话
• 高级操作：克隆、重命名、切换、导出/导入会话配置
• 会话信息：详细的会话信息和健康监测

🔧 窗格管理

具有高级定位功能的全面窗格控制：

• 基本操作：创建、关闭、聚焦、调整大小、交换窗格
• 高级功能：堆叠窗格、浮动窗格控件、全屏切换
• 内容操作：清除、转储屏幕、编辑回滚、滚动控件
• 定位：精确的浮动坐标控制

📑 选项卡管理

带有导航和组织的完整选项卡生命周期：

• 选项卡操作：创建、关闭、重命名、移动选项卡
• 导航：按索引/名称、下一个/上一个导航转到选项卡
• 高级功能：查询选项卡名称，跨窗格同步输入

🔌 插件管理

全面的插件生态系统集成：

• 插件生命周期：启动、聚焦、启动/重新加载插件
• 高级选项：浮动、就地、跳过缓存配置
• 插件信息：列出别名、正在运行的插件、插件信息
• 配置：完整的插件配置支持

📐 布局管理

完整的布局系统，并经过验证：

• 布局操作：转储、保存、应用、加载布局
• 高级功能：带有布局的新选项卡，布局验证
• 布局发现：列出支持自定义目录的可用布局

🔄 管道系统

高级插件间通信：

• 基础管道：向插件发送数据，向所有插件广播
• 高级管道：响应捕获，基于文件的管道
• 动作管道：强制启动、跳过缓存、浮动选项
• 插件定位：特定插件URL定位

🤖 LLM完井检测

LLM工作流集成专用工具：

• 过程监控：监视管道、轮询进程、文件监视
• 超时管理：自动超时完成
• 包装脚本：LLM完井检测器包装
• 资源清理：自动清理检测资源

🛡️ 安全与性能

企业级安全和性能特征：

• 输入验证：全面的输入净化和验证
• 速率限制：每个工具可配置的速率限制
• 缓存：具有统计信息的智能缓存
• 健康监测：系统健康检查和诊断

安装

先决条件

• Node.js 18或更高版本
• Zellij已安装并在PATH中可用
• 主动终端环境

设置

# Clone the repository
git clone https://github.com/yourusername/zellij-mcp-server.git
cd zellij-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Make the script executable
chmod +x dist/index.js

用法

使用克劳德桌面

将此添加到您的Claude Desktop配置文件中：

{
  "mcpServers": {
    "zellij": {
      "command": "node",
      "args": ["/path/to/zellij-mcp-server/dist/index.js"]
    }
  }
}

直接使用

# Start the MCP server
npm start

# Development mode with watching
npm run dev

工具类别

会话管理工具

窗格管理工具

选项卡管理工具

插件管理工具

布局管理工具

管道系统工具

LLM检测工具

系统工具

示例用法

创建开发会话

{
  "name": "zellij_new_session",
  "arguments": {
    "session_name": "development",
    "layout": "dev-layout"
  }
}

在面板中运行命令

{
  "name": "zellij_run_command",
  "arguments": {
    "command": "npm run dev",
    "direction": "right"
  }
}

插件管理

{
  "name": "zellij_launch_plugin",
  "arguments": {
    "plugin_url": "file:~/.config/zellij/plugins/filepicker.wasm",
    "floating": true,
    "width": "50%",
    "height": "50%"
  }
}

布局操作

{
  "name": "zellij_save_layout",
  "arguments": {
    "layout_name": "my-dev-setup"
  }
}

LLM集成

创建LLM包装脚本

这 zellij_create_llm_wrapper 该工具生成智能包装脚本，为任何LLM命令提供强大的完成检测：

{
  "name": "zellij_create_llm_wrapper",
  "arguments": {
    "wrapper_name": "claude-wrapper",
    "llm_command": "claude chat",
    "detect_marker": ">>",
    "timeout_ms": 60000
  }
}

包装器提供了什么：

• 多信号检测：退出代码、完成标记和状态文件
• 自动超时处理：可配置的超时，具有优雅的清理功能
• 过程监控：实时状态跟踪和记录
• 信号处理：中断时的适当清理（信号情报、信号期限）
• 时间戳日志记录：用于调试的详细执行日志

生成的文件：

• /tmp/llm-wrapper-{name}.sh -可执行包装器脚本
• /tmp/llm-status-{name} -带有时间戳的实时状态文件
• /tmp/llm-output-{name}-{pid} -捕获的输出（临时）

使用示例：

# After creating the wrapper, use it like:
/tmp/llm-wrapper-claude-wrapper.sh "Explain quantum computing"

# Monitor status in real-time:
tail -f /tmp/llm-status-claude-wrapper

# The wrapper handles timeouts, signals, and cleanup automatically

状态跟踪：

• running -LLM查询正在进行中
• complete:0 -已成功完成
• timeout -查询超时
• error:N -退出代码N失败

建筑

安全功能

• 输入验证：所有输入都经过验证和消毒
• 速率限制：每个工具的速率限制（每分钟50个请求）
• 路径横向保护：文件路径验证阻止目录遍历
• 命令注入预防：命令清理和验证

性能特点

• 智能高速缓存：缓存会话列表和其他数据
• 异步操作：所有操作都是异步的
• 错误处理：针对特定错误类型的全面错误处理
• 资源清理：自动清理临时资源

错误处理

服务器包括针对特定错误类型的全面错误处理：

• ValidationError：输入验证失败
• SecurityError：安全相关错误（速率限制等）
• ZellijError：Zellij特定命令失败

发展

项目结构

src/
├── index.ts              # Main MCP server implementation
├── tools/               # Tool modules
│   ├── detection.ts     # LLM completion detection tools
│   ├── layouts.ts       # Layout management tools
│   ├── panes.ts         # Pane management tools
│   ├── piping.ts        # Piping system tools
│   ├── plugins.ts       # Plugin management tools
│   └── sessions.ts      # Session management tools
├── types/
│   └── zellij.ts        # TypeScript type definitions
└── utils/
    ├── cache.ts         # Caching utilities
    ├── command.ts       # Command execution utilities
    └── validator.ts     # Input validation utilities

建筑

# Development build with watching
npm run dev

# Production build
npm run build

# Start the built server
npm start

测试

跑 ./test-workflow.sh 以验证检测系统功能。

贡献

1. 分叉存储库
2. 创建要素分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add some amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

致谢

• 塞利 -令人惊叹的终端工作空间管理器
• 模型上下文协议 -此服务器实现的协议
• 克劳德代码 -与Claude AI集成

支持

有关问题、疑问或贡献，请访问 .