Skip to content

seed-viz

Vision analysis CLI + MCP server backed by Seed 2.0 via Volcano Ark or any OpenAI-compatible endpoint

3,400
Weekly Downloads
build.protocol_tooling.mcp#seed#seed-2#vision#multimodal#cli#mcp#mcp-server#volcano-ark#litellm

Install seed-viz in your MCP client

seed-viz is a Model Context Protocol server. Add it to your MCP client config once, restart, and the server's tools become available to your AI assistant. The same JSON snippet below works across all four major clients — only the config file path differs.

  1. Locate your client's MCP config file.
    • Cursor: ~/.cursor/mcp.json
    • Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
    • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
    • VS Code: Settings → Extensions → MCP
    • Windsurf: Settings → MCP Servers
  2. Add seed-viz to the mcpServers map — paste the snippet below into your config file. If you already have other MCP servers, merge the entry into the existing mcpServers object.
  3. Restart your client so it picks up the new server.
  4. Verify — ask the assistant to list available tools; seed-viz's tools should appear.
{
  "mcpServers": {
    "seed-viz": {
      "command": "npx",
      "args": [
        "-y",
        "@joezm/seed-viz"
      ]
    }
  }
}

Install seed-viz in Cursor

Open ~/.cursor/mcp.json in your editor, paste the snippet above into mcpServers, save, and restart Cursor. seed-viz will show up in the assistant's tool list on next launch.

Install seed-viz in Claude Desktop (macOS)

Open ~/Library/Application Support/Claude/claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (macOS). seed-viz will show up in the assistant's tool list on next launch.

Install seed-viz in Claude Desktop (Windows)

Open %APPDATA%\Claude\claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (Windows). seed-viz will show up in the assistant's tool list on next launch.

Install seed-viz in VS Code

Open Settings → Extensions → MCP in your editor, paste the snippet above into mcpServers, save, and restart VS Code. seed-viz will show up in the assistant's tool list on next launch.

npm package: @joezm/seed-viz

Transport

seed-viz supports the following MCP transports. Most AI clients use stdio by default for locally-installed servers.

stdio

From the seed-viz README

# seed-viz 视觉分析 CLI + MCP 服务器,支持字节跳动 Seed 2.0 视觉模型(火山方舟),或任意 OpenAI 兼容端点(LiteLLM 代理、OpenAI、Anthropic 代理等)。 ## 快速开始 ```bash npm install -g @joezm/seed-viz ``` 验证安装: ```bash seed-viz --help ``` 在项目目录创建最小的 `.env`: ```ini SEED_VIZ_API_KEY=你的火山方舟-key ``` 在[火山引擎 Ark 控制台](https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey)获取 API Key。 测试一下: ```bash seed-viz general-image your-image.png ``` ## 配置 CLI 启动时自动按顺序查找第一个 `.env`:当前目录 → `~/.seed-viz.env` → `$XDG_CONFIG_HOME/seed-viz/.env`(`XDG_CONFIG_HOME` 未设时默认 `~/.config/seed-viz/.env`)。Shell 中 export 的环境变量优先级高于 `.env` 文件。 ### 环境变量 | 变量 | 默认值 | 用途 | |---|---|---| | `SEED_VIZ_API_KEY` | *(必填)* | 全局 API 密钥(所有未单独配置的档位都使用它) | | `SEED_VIZ_BASE_URL` | `https://ark.cn-beijing.volces.com/api/v3` | 全局 OpenAI 兼容 base URL | | `SEED_VIZ_MOD

Other Model Context Protocol servers in the same space as seed-viz. Each one adds different capabilities to your AI assistant — pick based on the data sources or workflows you need.

Browse the full MCP server directory or use Stork's one-line install to let your agent pick the right server automatically.