MCP 服务器 - 图像

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

支持我们

如果您觉得这个项目很有帮助，并且愿意支持未来的项目，不妨请我们喝杯咖啡！您的支持将帮助我们继续构建创新的人工智能解决方案。

您的贡献极大地激发了我们创建智能且用户友好的应用程序的热情。

特征

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

先决条件

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

安装

克隆此存储库
使用 uv 创建并激活虚拟环境：

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

使用 uv 安装依赖项：

uv pip install -r requirements.txt

运行服务器

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

1.直接法

直接启动 MCP 服务器：

uv run python mcp_image.py

2. 配置 Windsurf/Cursor

风帆冲浪

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

编辑配置文件 ~/.codeium/windsurf/mcp_config.json
添加以下配置：

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

光标

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

打开 Cursor 并进入设置（导航栏 → 光标设置）
导航至功能→ MCP 服务器
点击 + 添加新的 MCP 服务器
输入以下配置：

{
  "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"
]

调试

如果您遇到任何问题：

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

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

MCP Image Server

Integrations