Vision MCP 管理器

使用说明

• 项目简介 Vision MCP 管理器是一个完整的 MCP（Model Context Protocol）服务器后端，负责托管并管理资源（Resources）、注册并执行工具（Tools），以及定义和渲染 Prompt 模板（Prompts），通过 JSON-RPC 与客户端通信。系统支持多种传输方式（如 STDIO、流式 HTTP、SSE），并提供会话管理、能力声明和可观测性（日志、健康状态等）。
• 主要功能点
  • 资源与工具管理：集中管理可用的资源和工具，支持远程调用和工具发现。
  • 会话化代理：为每个客户端会话创建独立的子进程/代理，提供隔离的执行环境与工具调用。
  • Prompts 与指引：通过 Instructions 提供服务器和工具的使用指引、偏好与示例，帮助 LLM 客户端选择最合适的能力。
  • 安全和运维：提供 Bearer 认证、Origin 白名单、速率限制、请求大小限制，以及热重载、自动重启等运维能力。
  • Admin API 与 OpenCode 集成：内置 Admin MCP Server，支持通过工具对系统进行自我管理与工具分发，并可与 OpenCode 集成生成客户端配置。
• 安装与运行步骤
  1. 构建与安装
     • 从源码编译 Vision MCP 管理器，确保使用 Go 1.24+ 环境。
     • 将可执行文件安装到系统 PATH 中，便于直接调用 vision 命令。
  2. 配置与启动
     • 在本地配置目录（例如 ~/.config/vision/）创建或编辑 servers.yaml，定义需要托管的 MCP 服务器及其启动参数。
     • 启动 Vision 守护进程，Vision 将自动加载配置、启动自带的 Admin MCP Server，并为 STDIO 类型服务器创建按会话隔离的代理端口。
  3. 使用 Admin API 与客户端集成
     • 使用 Admin MCP Tool（vision_list、vision_add、vision_remove、vision_status、vision_search、vision_init 等）对服务器进行运维和扩展。
     • 将 Vision 暴露的端点（如 http://localhost:627X/mcp）用于 OpenCode、Claude Code 等 LLM 客户端的上下文服务接入。
• 服务器配置（示例，供 MCP 客户端参考） 下面给出一个示例配置，用于 MCP 服务器的启动命令及参数。MCP 客户端不需要直接查看或修改这些信息，但需要知道它们所在的服务器端口与名称以建立连接。请将以下内容用于生成您的实际 config 文件并替换其中的 API Key 等敏感值： { "servers": { "time": { "port": 6282, "command": "uvx", "args": ["mcp-server-time", "--local-timezone=America/New_York"], "autostart": true }, "context7": { "port": 6276, "command": "npx", "args": ["-y", "@upstash/context7-mcp@latest"], "env": { "CONTEXT7_API_KEY": "YOUR_CONTEXT7_API_KEY" }, "autostart": true }, "kagi": { "port": 6284, "command": "uvx", "args": ["kagimcp"], "env": { "KAGI_API_KEY": "YOUR_KAGI_API_KEY" }, "autostart": true } } } 注：以上示例中的 API_KEY 等请替换为您实际的密钥，且配置文件路径建议放在本地配置目录，不要提交到版本控制。
• 基本使用方法
  • 启动与监控：使用 vision daemon start 启动守护进程，Vision 会加载配置、启动管理端点，并对 STDIO 服务器建立会话级代理。
  • 管理工具：通过 Admin MCP Tools 进行服务器注册、启动、停止、状态查询等操作，所有操作均可在一个统一的后台视图中查看。
  • 会话与代理：每个客户端会话分配一个独立的代理子进程，工具调用与日志等事件可通过代理回传到上游客户端。
  • 安全与暴露：若开启 Bearer Token 与 Origin 白名单，客户端在接入时需要带上 Authorization 与符合允许域名的 Origin；同时支持 CORS、速率限制等保护。