vision-mcp-ms
A cloud vision MCP server that enables text-only LLMs like DeepSeek to analyze images via OpenAI-compatible APIs (e.g., SiliconFlow), offering a single analyze_image tool with support for URL/data URLs and automatic model fallback.
README
vision-mcp-ms
云端视觉 MCP 服务:通过 OpenAI 兼容接口(默认硅基流动 SiliconFlow)分析图片, 为 DeepSeek 这类纯文本大模型提供「看图」能力。
- 单一工具
analyze_image(image, prompt) - 支持 HTTP(S) 图片 URL 和 base64 data URL
- 多模型按顺序自动 fallback(限流 / 超时 / 5xx 时切下一个)
- 纯 API 调用、不依赖本地环境,可部署到魔搭 MCP 广场云端托管
环境变量
| 变量 | 必填 | 默认值 | 说明 |
|---|---|---|---|
OPENAI_API_KEY |
是* | - | API Key(也兼容 SILICONFLOW_API_KEY / API_KEY) |
OPENAI_BASE_URL |
否 | https://api.siliconflow.cn/v1 |
OpenAI 兼容接口地址 |
VISION_MODELS |
否 | Qwen/Qwen2.5-VL-7B-Instruct |
逗号分隔的有序模型列表,靠前的优先 |
VISION_REQUEST_TIMEOUT_MS |
否 | 60000 |
单次模型请求超时(毫秒) |
* 部署时在魔搭 / MCP 客户端的 env 里配置。
本地使用(stdio)
在 MCP 客户端(Cherry Studio 桌面版等)里添加:
{
"mcpServers": {
"vision-mcp-ms": {
"command": "uvx",
"args": ["vision-mcp-ms"],
"env": {
"OPENAI_API_KEY": "sk-你的硅基流动Key",
"OPENAI_BASE_URL": "https://api.siliconflow.cn/v1",
"VISION_MODELS": "Qwen/Qwen2.5-VL-7B-Instruct,Qwen/Qwen2.5-VL-72B-Instruct"
}
}
}
}
本地 stdio 模式下,
image参数也支持本地文件绝对路径(如D:\Pictures\a.png)。 云端托管模式下仅支持 URL / data URL(服务端读不到你的本地文件)。
开发 / 测试
uv sync # 建环境
uv run python -m vision_mcp # 以 stdio 模式启动
uv run python -c "from vision_mcp.server import _to_data_url; print(_to_data_url('https://httpbin.org/image/jpeg')[:40])"
发布到 PyPI
cd vision-mcp-ms
uv run python -m build
uv run twine upload dist/*.whl
部署到魔搭 MCP 广场(云端托管)
- 把代码推到 GitHub 仓库(或发布到 PyPI 后)。
- 打开 https://www.modelscope.cn/mcp/servers/create?template=customize
- 托管类型选「可托管部署」,来源选你的 GitHub 仓库 / PyPI 包。
- 配置
command/args(如uvx/vision-mcp-ms),在 env 里填OPENAI_API_KEY、OPENAI_BASE_URL、VISION_MODELS。 - 创建后魔搭会自动部署,得到一个 HTTP 地址,填入手机 MCP 客户端即可。
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.
E2B
Using MCP to run code via e2b.