MCP Server - 图像

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

支持我们

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

<a href="https://www.buymeacoffee.com/blazzmocompany"><img src="https://img.buymeacoffee.com/button-api/?text=给我买杯咖啡&emoji=&slug=blazzmocompany&button_colour=40DCA5&font_colour=ffffff&font_family=Cookie&outline_colour=000000&coffee_colour=FFDD00"></a>

你的贡献对激发我们创造智能且用户友好的应用程序的热情有着巨大的推动作用。

目录

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

特性

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

前提条件

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

安装

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

uv venv
# 在Windows上：
.venv\Scripts\activate
# 在Unix/MacOS上：
source .venv/bin/activate

3. 使用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或文件路径列表]"
• "加载并处理这个本地图像：[文件路径]"

示例

# 仅URL测试
[
  "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"
]

# 混合URL和本地文件测试
[
  "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文件。