MCP Server - Image
2025.03.22
1
Python图像处理图像获取内容生成
MCP Server - Image 是一个基于 Model Context Protocol (MCP) 的服务，专注于从 URL、本地文件路径和 numpy 数组中获取和处理图像。该服务提供了 fetch_images 工具，能够将图像转换为 base64 编码的字符串并返回其 MIME 类型。
View on GitHub
Overview
基本能力
产品定位
MCP Server - Image 是一个图像获取和处理服务，适用于需要从多种来源获取图像并进行处理的场景。
核心功能
- 从 URL (http/https) 获取图像
- 从本地文件路径加载图像
- 对大型本地图像进行专门处理
- 自动压缩大于 1MB 的图像
- 并行处理多个图像
- 对不同文件扩展名进行正确的 MIME 类型映射
- 全面的错误处理和日志记录
适用场景
- 需要从网络或本地获取图像的应用
- 需要批量处理图像的应用
- 需要自动压缩大型图像的应用
工具列表
- fetch_images: 从 URL 或本地文件路径获取和处理图像，返回 base64 编码的图像和 MIME 类型。
常见问题解答
- 检查所有依赖是否正确安装
- 确保服务正在运行并监听连接
- 对于本地图像加载问题，确保文件路径正确且可访问
- 对于“不支持的图像类型”错误，验证内容类型处理
- 查看服务器输出中的错误消息
使用教程
使用依赖
- Python 3.10+
- uv 包管理器（推荐）
安装教程
- 克隆仓库
- 创建并激活虚拟环境：
uv venv
# On Windows:
.venv\Scripts\activate
# On Unix/MacOS:
source .venv/bin/activate
- 安装依赖：
uv pip install -r requirements.txt
运行服务器
直接方法
uv run python mcp_image.py
配置 Windsurf/Cursor
Windsurf
- 编辑配置文件
~/.codeium/windsurf/mcp_config.json - 添加配置：
{
"mcpServers": {
"image": {
"command": "uv",
"args": ["--directory", "/path/to/mcp-image", "run", "mcp_image.py"]
}
}
}
Cursor
- 打开 Cursor 并转到 Settings (Navbar → Cursor Settings)
- 导航到 Features → MCP Servers
- 点击 + Add New MCP Server
- 输入配置：
{
"mcpServers": {
"image": {
"command": "uv",
"args": ["--directory", "/path/to/mcp-image", "run", "mcp_image.py"]
}
}
}
调试方式
- 检查依赖是否正确安装
- 确保服务正在运行
- 验证文件路径是否正确
- 查看服务器输出中的错误消息