MCP Server - 图像

一个模型上下文协议（MCP）服务器，提供从URL、本地文件路径和numpy数组中获取和处理图像的工具。该服务器包括一个名为fetch_images的工具，它将图像作为base64编码的字符串返回，并附带其MIME类型。

支持我们

如果您觉得这个项目对您有帮助并希望支持未来的项目，请考虑给我们买杯咖啡！您的支持有助于我们继续构建创新的人工智能解决方案。

您的贡献对我们来说意义重大，激发了我们创造智能且用户友好的应用程序的热情。

目录

• 特性
• 先决条件
• 安装
• 运行服务器
  • 直接方法
  • 为Windsurf/Cursor配置
• 可用工具
  • 使用示例
• 调试
• 贡献
• 许可证

特性

• 从URL (http/https) 获取图像
• 从本地文件路径加载图像
• 对大型本地图像进行专门处理
• 自动压缩大于1MB的图像
• 并行处理多个图像
• 不同文件扩展名的适当MIME类型映射
• 全面的错误处理和日志记录

先决条件

• Python 3.10+
• uv包管理器（推荐）

安装

1. 克隆此仓库
2. 使用uv创建并激活虚拟环境：

uv venv
# On Windows:
.venv\Scripts\activate
# On Unix/MacOS:
source .venv/bin/activate

1. 使用uv安装依赖项：

uv pip install -r requirements.txt

运行服务器

有两种方式来运行MCP服务器：

1. 直接方法

要直接启动MCP服务器：

uv run python mcp_image.py

2. 为Windsurf/Cursor配置

Windsurf

要将此MCP服务器添加到Windsurf中：

1. 编辑位于~/.codeium/windsurf/mcp_config.json的配置文件
2. 添加以下配置：

{
  "mcpServers": {
    "image": {
      "command": "uv",
        "args": ["--directory", "/path/to/mcp-image", "run", "mcp_image.py"]
    }
  }
}

Cursor

要将此MCP服务器添加到Cursor中：

1. 打开Cursor并转到设置（导航栏 → Cursor设置）
2. 导航至功能 → MCP服务器
3. 点击+添加新的MCP服务器
4. 输入以下配置：

{
  "mcpServers": {
    "image": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-image", "run", "mcp_image.py"]
    }
  }
}

可用工具

服务器提供了以下工具：

fetch_images: 从URL或本地文件路径获取并处理图像
参数：
image_sources: 图像的URL或文件路径列表
返回：
带有base64编码和MIME类型的已处理图像列表

使用示例

现在您可以使用如下命令：

• "获取这些图像：[URL或文件路径列表]"
• "加载并处理此本地图像：[file_path]"

示例

# URL-only test
[
  "https://upload.wikimedia.org/wikipedia/commons/thumb/7/70/Chocolate_%28blue_background%29.jpg/400px-Chocolate_%28blue_background%29.jpg",
  "https://imgs.search.brave.com/Sz7BdlhBoOmU4wZjnUkvgestdwmzOzrfc3GsiMr27Ik/rs:fit:860:0:0:0/g:ce/aHR0cHM6Ly9pbWdj/ZG4uc3RhYmxlZGlm/ZnVzaW9ud2ViLmNv/bS8yMDI0LzEwLzE4/LzJmOTY3NTViLTM0/YmQtNDczNi1iNDRh/LWJlMTVmNGM5MDBm/My5qcGc",
  "https://shigacare.fukushi.shiga.jp/mumeixxx/img/main.png"
]

# Mixed URL and local file test
[
  "https://upload.wikimedia.org/wikipedia/commons/thumb/7/70/Chocolate_%28blue_background%29.jpg/400px-Chocolate_%28blue_background%29.jpg",
  "C:\\Users\\username\\Pictures\\image1.jpg",
  "https://imgs.search.brave.com/Sz7BdlhBoOmU4wZjnUkvgestdwmzOzrfc3GsiMr27Ik/rs:fit:860:0:0:0/g:ce/aHR0cHM6Ly9pbWdj/ZG4uc3RhYmxlZGlm/ZnVzaW9ud2ViLmNv/bS8yMDI0LzEwLzE4/LzJmOTY3NTViLTM0/YmQtNDczNi1iNDRh/LWJlMTVmNGM5MDBm/My5qcGc",
  "C:\\Users\\username\\Pictures\\image2.jpg"
]

调试

如果您遇到任何问题：

1. 确认所有依赖项已正确安装
2. 验证服务器正在运行并监听连接
3. 对于本地图片加载问题，确保文件路径正确且可访问
4. 对于“不支持的图片类型”错误，请验证内容类型处理
5. 查看服务器输出中的任何错误消息

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目根据 MIT 许可证授权 - 详情请参阅 LICENSE 文件。