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）