MCP Image Server

MCP服务器-映像

一种模型上下文协议（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

帆板运动

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

1. 在~/.codium/wundurf/mcp_gonfig.json处编辑配置文件
2. 添加以下配置：

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

光标

要将此MCP服务器添加到游标，请执行以下操作：

1. 打开光标并转到 *设置* （导航栏→ 光标设置）
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. 在服务器输出中查找任何错误消息

贡献

欢迎投稿！请随时提交拉取请求。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。