@trinity-mcp/trinity-vision

让没有原生识图能力的 Agent，通过 Trinity API（OpenAI 兼容 chat/completions）看图。

基于开源 claude-vision-skill（MIT）改造为本地 MCP，形态对齐 Trinity Memory。

安装

用 trinity-config --name 选插件（与接 API 分开）：

npx -y trinity-config --name vision --type claude -k xh-你的key
npx -y trinity-config --name vision --type claude -k xh-你的key --vision-model qwen-vl-max

| --name | 插件 | |---|---| | vision | Trinity Vision（识图） | | memory | Trinity Memory（代码图谱） |

手动配置示例：

{
  "mcpServers": {
    "trinity-vision": {
      "command": "npx",
      "args": ["-y", "@trinity-mcp/trinity-vision"],
      "env": {
        "TRINITY_API_KEY": "xh-你的key",
        "TRINITY_VISION_MODEL": "qwen-vl-max"
      }
    }
  }
}

MCP Tools

| Tool | 说明 | |------|------| | vision_describe | 描述图片（本地路径或 URL） | | vision_ask | 就图片提问 | | vision_status | 查看配置（不回显完整 Key） |

环境变量

| 变量 | 默认 | 说明 | |------|------|------| | TRINITY_API_KEY | — | 必填；兼容 OPENAI_API_KEY | | TRINITY_BASE_URL | https://api.trinitydesk.ai/v1 | 兼容 OPENAI_BASE_URL | | TRINITY_VISION_MODEL | qwen-vl-max | 须支持 image_url 的上架模型 | | TRINITY_VISION_MAX_TOKENS | 1024 | | | TRINITY_VISION_TIMEOUT_MS | 60000 | | | TRINITY_VISION_MAX_IMAGE_BYTES | 10485760 | 默认 10 MiB |

开发

npm install
npm run typecheck
npm run test
npm run build

许可证

MIT。上游声明见 NOTICE.md。