MCP 服务器

MCP Image Server

一个模型上下文协议（Model Context Protocol）服务器，能够从 URL、本地文件路径和 NumPy 数组中获取和处理图像，并将它们作为带有正确 MIME 类型的 Base64 编码字符串返回。

README

MCP 服务器 - 图像

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

支持我们

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

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

特性

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

先决条件

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

安装

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

uv venv
# 在 Windows 上：
.venv\Scripts\activate
# 在 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

Windsurf

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

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

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

Cursor

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

打开 Cursor 并转到 Settings（导航栏 → Cursor Settings）
导航到 Features → MCP Servers
单击 + Add New MCP Server
输入以下配置：

{
  "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 测试
[
  "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"
]