opencode-eyes
MCP server that provides image description capability using StepFun Step-3.7-flash multimodal model, enabling models to 'see' images by converting them into detailed text descriptions.
README
opencode-eyes 👁️
MCP server that provides image description capability using StepFun Step-3.7-flash multimodal model.
为不具备多模态能力的模型提供**"眼睛"**。将图片输入,即可获得详细的图片文字描述。
功能
| 工具 | 说明 |
|---|---|
describe_image |
描述一张图片的内容,使用 StepFun Step-3.7-flash 多模态大模型 |
环境变量
| 变量 | 必填 | 默认值 | 说明 |
|---|---|---|---|
STEP_API_KEY |
是 | — | StepFun API Key |
STEP_MODEL |
否 | step-3.7-flash |
使用的模型名称(Step Plan 专用地址 https://api.stepfun.com/step_plan/v1) |
STEP_TIMEOUT |
否 | 120 |
StepFun API 请求超时(秒) |
STEP_MAX_DIMENSION |
否 | 2048 |
发送前图片最长边缩放到该像素,0 表示不缩放 |
STEP_JPEG_QUALITY |
否 | 85 |
发送前 JPEG 压缩质量(0-100) |
更新日志 (v1.0.2)
- 修复 MCP -32001 Request timed out:发送前将图片缩放/压缩为 JPEG,大幅减小 payload、降低 API 延迟,避免超过 MCP 客户端默认 5s 超时。
- 修复空描述:
step-3.7-flash有时把答案放在reasoning_content/reasoning而content为空,现已自动回退。 - 修复 Windows 中文乱码:stdout/stdin 改为 UTF-8 字节读写。
- 新增
ping方法支持,更健壮的 MCP 握手。
注意:opencode 的 MCP 请求超时默认为 5000ms。若仍需更宽松的超时,可在 opencode 配置中为该 MCP 设置
"timeout": 120000,或全局设置"experimental": { "mcp_timeout": 120000 }。
安装
pip install Pillow
运行
# 设置环境变量
set STEP_API_KEY=你的StepFun API Key
# 启动服务
python -m opencode_eyes
在 OpenCode 中配置
{
"mcp": {
"opencode-eyes": {
"type": "local",
"command": ["python", "-m", "opencode_eyes"],
"enabled": true,
"timeout": 120000,
"environment": {
"STEP_API_KEY": "你的StepFun API Key"
}
}
}
}
License
MIT
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.
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.
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.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
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.
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.
E2B
Using MCP to run code via e2b.
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.