Ghostty Image MCP

重影图像mcp

在中内联显示图像的MCP服务器 鬼影 使用 Kitty图形协议.

专为配合使用而设计 克劳德代码，但适用于在Kitty兼容终端中运行的任何MCP客户端。

特性

• 直接在终端中显示图像（PNG、JPEG、SVG、PDF等）
• PDF支持页面选择(page 参数，1索引）
• 可调刻度（端子宽度的10%-100%）
• 终端自动对中
• 通过以下方式自动将格式转换为PNG sips （macOS）， rsvg-convert （SVG）和CoreGraphics（PDF）
• 唯一的图像ID，因此多个图像在终端回滚中共存
• 无逃逸序列泄漏(q=2 抑制所有协议响应）

需求

• macOS（使用 sips 用于图像转换）
• Python 3.10+
• 紫外线
• 一种兼容Kitty图形协议的终端(鬼影, 凯蒂等等）
• rsvg-convert （可选，用于SVG支持——通过安装 brew install librsvg)

设置

1. 克隆此仓库：

git clone https://github.com/jrmeyer/ghostty-image-mcp.git

1. 添加到您的Claude代码配置中。运行：

claude mcp add ghostty-image -- uv run /path/to/ghostty-image-mcp/server.py

或手动添加到 ~/.claude.json:

{
  "mcpServers": {
    "ghostty-image": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "/path/to/ghostty-image-mcp/server.py"]
    }
  }
}

1. 重新启动克劳德代码。

用法

从Claude Code中，让它显示一个图像：

show me ~/photos/cat.jpg

这 show_image 工具接受：

• file_path --图像文件的路径（PNG、JPEG、SVG、PDF或任何格式 sips 可以转换）
• scale --要使用的端子宽度分数（0.1-1.0，默认值0.75）
• page --PDF的页码（1-索引，默认为1）

运作原理

服务器在启动时（在MCP stdio传输接管之前）捕获控制TTY，然后使用原始文件描述符I/O直接写入Kitty图形协议转义序列(os.write).它使用基于文件的传输(t=f)--终端通过一个小的转义序列直接从磁盘读取PNG文件。每个图像都有一个唯一的ID，因此多个图像可以在终端回滚中共存，而不会相互驱逐。 q=2 抑制终端确认响应，从而防止转义序列文本泄露到Claude Code等TUI应用程序中。

已知限制

• 重影图像内存限制：Ghostty限制了回滚中保存的图像的数量/大小。当显示许多高分辨率图像（例如，大型PDF的页面）时，随着新图像的添加，旧图像可能会消失。较小或压缩的图像允许更多的图像同时在回滚中共存。
• t=t 不支持（临时文件传输）：Ghostty不支持Kitty t=t 传输模式。此服务器使用 t=f （文件传输），终端从磁盘读取文件，但不删除它。