AI导哈

图像查看器MCP

一个模型上下文协议（MCP）服务器，用于在Claude对话中直接显示本地文件系统中的图像。

  • by itrimble
  • TypeScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 itrimble/image-viewer-mcp

使用说明

图像查看器MCP

一个模型上下文协议（MCP）服务器，用于在Claude对话中直接显示来自本地文件系统的图像。

特性

  • 显示图像：直接在Claude中查看实际图像（不仅仅是OCR）
  • 图像信息：获取有关图像文件的详细元数据
  • 目录列表：查找并列出目录中的所有图像
  • 多种格式：支持JPG、PNG、GIF、BMP、WebP和SVG文件
  • 路径解析：主目录和相对路径支持~

安装

  1. 构建项目：
npm install
npm run build
  1. 添加到您的Claude MCP配置中（通常在 ~/Library/Application Support/Claude/claude_desktop_config.json):
{
  "mcpServers": {
    "image-viewer": {
      "command": "node",
      "args": ["/Users/ian/image-viewer-mcp/dist/index.js"]
    }
  }
}

可用工具

显示图像

显示文件系统中的图像。将图像作为Claude可以渲染的base64数据返回。

  • imagePath （string）：图像文件的路径（主目录支持~）

列出图像

查找并列出目录中的图像文件。

  • searchPath （string）：用于搜索图像的目录路径
  • recursive （布尔值，可选）：是否递归搜索子目录

图像信息

在不加载完整图像数据的情况下获取有关图像文件的详细信息。

  • imagePath （string）：图像文件的路径

使用示例

Display the headshot image:
- Tool: display-image
- imagePath: ~/Pictures/Headshot_Headphones.jpg

List all images in Pictures folder:
- Tool: list-images  
- searchPath: ~/Pictures
- recursive: false

Get info about an image:
- Tool: image-info
- imagePath: ~/Pictures/Headshot_Headphones.jpg

故障排除

  • 确保图像文件存在并且可读
  • 检查文件扩展名是否受支持
  • 验证路径是否正确（使用绝对路径以确保可靠性）
  • 由于base64编码，加载大图像可能需要更长的时间

支持的图像类型

  • JPEG（.jpg、.JPEG）
  • PNG（.PNG）
  • GIF（.GIF）
  • BMP（.BMP）
  • WebP（.WebP）
  • SVG（.SVG）

相关 MCP