图像分析服务

一个使用OpenRouter视觉模型分析图像的MCP服务器,提供简单接口通过多种视觉模型(如Claude-3.5-sonnet和Claude-3-opus)分析图像。

  • by catalystneuro
  • JavaScript
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 catalystneuro/mcp_read_images

使用说明

MCP读取图像

用于使用OpenRouter视觉模型分析图像的MCP服务器。该服务器提供了一个简单的界面,通过OpenRouter API使用各种视觉模型来分析图像,如Claude-3.5-sonnet和Claude-3-opus。

安装

npm install @catalystneuro/mcp_read_images

配置

服务器需要一个OpenRouter API密钥。你可以从 OpenRouter 的.

将服务器添加到MCP设置文件(通常位于 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 对于VSCode):

{
  "mcpServers": {
    "read_images": {
      "command": "read_images",
      "env": {
        "OPENROUTER_API_KEY": "your-api-key-here",
        "OPENROUTER_MODEL": "anthropic/claude-3.5-sonnet"  // optional, defaults to claude-3.5-sonnet
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

用法

服务器提供单一工具 analyze_image 其可用于分析图像:

// Basic usage with default model
use_mcp_tool({
  server_name: "read_images",
  tool_name: "analyze_image",
  arguments: {
    image_path: "/path/to/image.jpg",
    question: "What do you see in this image?"  // optional
  }
});

// Using a specific model for this call
use_mcp_tool({
  server_name: "read_images",
  tool_name: "analyze_image",
  arguments: {
    image_path: "/path/to/image.jpg",
    question: "What do you see in this image?",
    model: "anthropic/claude-3-opus-20240229"  // overrides default and settings
  }
});

模型选择

按以下优先顺序选择模型:

  1. 工具调用中指定的模型(model 论点)
  2. MCP设置中指定的型号(OPENROUTER_MODEL 环境变量)
  3. 默认型号(人/claude-3.5连接器)

支持的型号

以下OpenRouter型号已经过测试:

  • 人型/claude-3.5onnet
  • 人/claude-3 opus-20240229

特性

  • 自动调整图像大小和优化
  • 可配置的模型选择
  • 支持有关图像的自定义问题
  • 详细的错误消息
  • 自动JPEG转换和质量优化

错误处理

服务器处理各种错误情况:

  • 图像路径无效
  • 缺少API密钥
  • 网络错误
  • 型号选择无效
  • 图像处理错误

每个错误都将返回一条描述性消息,以帮助诊断问题。

发展

要从源代码构建,请执行以下操作:

git clone https://github.com/catalystneuro/mcp_read_images.git
cd mcp_read_images
npm install
npm run build

许可证

MIT许可证。看 许可证 了解详情。