Image Reader MCP Server

Image Reader MCP Server

site icon
2025.05.04 1
TypeScript图像处理文件操作其它
Image Reader MCP Server 是一个基于 FastMCP 构建的简单 MCP 服务器,主要用于处理和操作图像文件。它提供了列出指定目录中的图像文件以及读取特定图像文件内容的功能。
View on GitHub

Overview

基本能力

产品定位

Image Reader MCP Server 是一个专门用于图像文件处理和操作的 MCP 服务器。

核心功能

  • 列出图像文件:扫描指定目录并列出其中的图像文件。
  • 读取图像内容:读取特定图像文件并将其内容以 base64 格式返回。

适用场景

  • 需要批量处理图像文件的自动化任务。
  • 需要动态加载和显示图像内容的应用程序。

工具列表

  1. list_images
  2. 描述:列出指定目录中的图像文件。
  3. 参数directoryPath(字符串):要扫描的目录的绝对路径。
  4. 返回:目录中找到的图像文件名列表或提示未找到图像的消息。
  5. 支持的扩展名.jpg, .jpeg, .png, .gif, .bmp, .webp, .svg

  6. read_image

  7. 描述:读取特定图像文件并返回其内容为 base64。
  8. 参数filePath(字符串):要读取的图像文件的绝对路径。
  9. 返回:包含图像内容的对象,适合显示(使用 fastmcpimageContent 助手)。
  10. 支持的扩展名.jpg, .jpeg, .png, .gif, .bmp, .webp, .svg

常见问题解答

  • 问题:在 Cursor 中使用时,为什么只有 Claude Sonnet 模型有效? 解答:目前似乎只有在选择 Claude Sonnet 时才能正常工作,其他模型可能未启用视觉功能。

使用教程

使用依赖

  • 需要安装 Node.js 和 npm。

安装教程

  1. 确保已安装 Node.js 和 npm。
  2. 通过 npm 安装 image-reader-mcpbash npm install image-reader-mcp
  3. 在 MCP 客户端配置中添加 imageReader 条目: json { "mcpServers": { "imageReader": { "command": "npx", "args": ["image-reader-mcp"], "env": {} } } }

调试方式

  • 运行 MCP 客户端并检查 imageReader 服务器是否正常启动。
  • 使用提供的工具(list_imagesread_image)进行测试,确保功能正常。

许可证

该项目遵循 GPL-3.0 开源许可条款,请参阅 GPL-3.0 了解完整条款。