视觉-MCP服务器

Name: 视觉-MCP服务器
Author: Markusbetter

作者：Markusbetter3 星标更新：2025-10-12

安装使用来源：spider==github.com

项目介绍

Vision MCP Server | 图像分析MCP

English | Chinese

中文

一个用于图像分析的MCP（模型上下文协议）服务器，支持图像内容分析和描述。例如，当客户端上的模型仅支持文本输入时，可以使用视觉模型MCP进行补充。该项目利用了来自ModelScope社区的免费视觉模型Qwen3-VL-30B-A3B-Instruct（您也可以在配置设置中替换为您喜欢的视觉模型）。

功能特性

支持本地图像文件和在线图像URL
基于ModelScope社区AI模型的智能图像分析
完全兼容MCP协议
支持TypeScript，提供完整的类型定义

安装

方案1：使用npx（推荐）

无需预安装，npx会自动下载并运行最新版本：

{
  "mcpServers": {
    "vision-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "vision-mcp-server"
      ],
      "env": {
        "MODELSCOPE_TOKEN": "your_modelscope_token_here",
        "MODELSCOPE_MODEL": "Qwen/Qwen3-VL-30B-A3B-Instruct"
      }
    }
  }
}

方法2：全局安装

npm install -g vision-mcp-server

然后在客户端配置中：

{
  "mcpServers": {
    "vision-mcp-server": {
      "command": "vision-mcp-server",
      "env": {
        "MODELSCOPE_TOKEN": "your_modelscope_token_here",
        "MODELSCOPE_MODEL": "Qwen/Qwen3-VL-30B-A3B-Instruct"
      }
    }
  }
}

方法3：本地安装

npm install vision-mcp-server

然后在客户端配置中：

{
  "mcpServers": {
    "vision-mcp-server": {
      "command": "node",
      "args": ["node_modules/vision-mcp-server/dist/index.js"],
      "env": {
        "MODELSCOPE_TOKEN": "your_modelscope_token_here",
        "MODELSCOPE_MODEL": "Qwen/Qwen3-VL-30B-A3B-Instruct"
      }
    }
  }
}

环境变量配置

在使用之前，需要设置以下环境变量：

MODELSCOPE_TOKENModelScope社区的API密钥（必需）
- 获取方式：访问ModelScope → 个人中心 → API Token
MODELSCOPE_MODEL要使用的模型名称（可选，默认是"Qwen/Qwen3-VL-30B-A3B-Instruct"）
- 支持其他视觉模型，如：Qwen/Qwen2-VL-7B-Instruct

使用示例

// 分析本地图片
{
  "name": "analyze_image",
  "arguments": {
    "image": "/path/to/your/image.jpg",
    "prompt": "请描述这张图片的内容"
  }
}

// 分析在线图片
{
  "name": "analyze_image",
  "arguments": {
    1. "image": "https://example.com/image.jpg",
    2. "prompt": "这张图片中有哪些物体？"
    3. }
    4. }

API参考

analyze_image

分析图像内容并提供详细描述。

参数：

image (string): 图像URL或本地文件路径
prompt (string, 可选): 图像的问题或分析请求，默认是"请描述这张图片的内容"

返回：图像内容的详细文本描述。

开发

构建

npm run build

测试

npm test

贡献

欢迎提交问题和拉取请求！

许可证

MIT

更新日志

1.0.0

初始版本发布
支持图像分析功能
兼容MCP协议

英文

一个支持图像内容分析和描述的Vision Analysis MCP（模型上下文协议）服务器。

特性

支持本地图像文件和在线图像URL
基于ModelScope AI模型的智能图像分析
完全兼容MCP协议
支持TypeScript，提供完整的类型定义

安装