终端内联图像显示工具

一个使用Kitty图形协议在支持该协议的终端(如Ghostty和Kitty)中直接显示图像的工具。

  • by yamalab
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 yamalab/view-image-mcp

使用说明

查看图像mcp

一种MCP服务器,可以在终端中在线显示Claude Code中的图像。

使用Kitty图形协议,在Ghostty和Kitty等对应终端上直接显示图像。

对应环境

  • 操作系统: macOS
  • 终端: 支持Kitty图形协议的终端
  • 运行时: Node.js v18+

支持的格式

|格式|对应方法| |---|---| |PNG|直接显示| |JPEG| sips 中转换为PNG进行显示 |GIF| sips 中转换为PNG进行显示 |WebP| sips 中转换为PNG进行显示

安装

git clone <repository-url>
cd view-image-mcp
npm install

注册Claude Code

claude mcp add view-image node /path/to/view-image-mcp/index.js

或 ~/.claude.json 的明细栏样式中定义的设置

{
  "mcpServers": {
    "view-image": {
      "command": "node",
      "args": ["/path/to/view-image-mcp/index.js"]
    }
  }
}

用法

在Claude Code上请求显示图像文件时view_image 将调用该工具并在终端上显示内联。

> この画像を表示して: /path/to/screenshot.png

工具: view_image

参数|类型|说明| |---|---|---| | path 图像文件路径(绝对路径或相对路径)

机制

Claude Code ←(stdio JSON-RPC)→ MCP Server
                                    │
                                    ├─ 画像ファイルを読み込み
                                    ├─ 必要に応じて PNG に変換 (sips)
                                    ├─ Base64 エンコード + チャンク分割
                                    └─ /dev/tty に Kitty グラフィクスプロトコルで書き込み
                                            │
                                            ▼
                                    ターミナルにインライン表示

单击功能区上 stdout 用于与Claude Code的JSON-RPC通信,因此图像数据 /dev/tty 中描述的场景,使用以下步骤创建明细表,以便在概念设计中分析体量的体积。

许可证

麻省理工学院