使用说明内容（Markdown格式）

项目简介

MCP Generative UI Wrapper 是一个基于 Model Context Protocol 的后端服务器，能够从上游 MCP 服务器自动生成并托管交互式 UI，提供工具调用、资源访问和 Prompt 渲染等能力。

主要功能

• 自动发现并暴露上游工具（Tools）供 MCP 客户端使用
• 根据工具自动生成可互动的 UI，支持两种标准（MCP Apps 与 OpenAI Apps SDK）
• UI 结果缓存，支持迭代式 refinement
• 支持多传输协议（stdio、HTTP/Streamable、SSE）
• 与 mcpblox 等管道整合，方便管道化处理
• 读取/渲染 资源 UI、执行工具调用、动态生成 UI
• 基于上游工具集合动态暴露和管理 UI，以及对 UI 的持续改进

安装与运行

• 克隆仓库并安装依赖
• 配置环境变量（如 API 密钥、代理配置等）
• 启动示例（需要将 upstream、LLM、密钥等替换为实际值）： mcp-gen-ui --upstream "node server.js" --provider anthropic --model claude-sonnet-4-20250514 --port 8000
• 访问 MCP 端点，例如 http://localhost:8000/mcp
• 与上游 MCP 服务器建立连接后，wrapper 会注册工具列表、资源以及生成的 UI

服务器配置示例

服务器配置用于 MCP 客户端了解如何连接和使用该 MCP 服务器。以下为字段含义与示例描述（实际使用请按需填写，MCP 客户端不需要你直接提供这段代码）：

• upstream
  • transport: 指定上游传输方式（如 streamable-http、sse、http、stdio、deferred 等）
  • url: 上游服务器地址（若使用网络传输）
  • bearerToken: 可选的 Bearer 认证令牌
  • command/args: 当 upstream 为本地进程时，指定启动命令及参数
• llm
  • provider: LLM 提供商（anthropic 或 openai）
  • model: 使用的具体模型（如 claude-sonnet-4-20250514、gpt-4o 等）
  • apiKey: 对应提供商的 API Key（密钥）
• cache
  • directory: 缓存 UI 的目录路径
• standard
  • openai 或 mcp-apps，决定 UI 生成的标准与渲染风格
• server
  • port: 服务器监听端口（若未指定，将在 OS 提供端口或默认端口启动）
• pipe
  • stdinIsPipe: 标记标准输入是否来自管道
  • stdoutIsPipe: 标记标准输出是否作为管道输出 URL
• prompt
  • 附加用于 UI 生成的提示文本，可与 prompt-file 合并使用

注：以上字段仅为描述用途，实际客户端配置请按 MCP 客户端的需要传递 JSON 配置项。MCP 客户端通常需要配置服务器的网络地址、端口等信息来建立连接。

基本使用

• 准备环境变量（如 LLM 提供商密钥）
• 启动 wrapper，指定上游 MCP 服务器与 LLM 配置
• 使用 MCP 客户端对 Tools、Resources 进行查询、调用，并通过自动生成的 UI 进行交互
• 如需 Refinement，可向工具发送 _ui_refine 或 _ui_regenerate 等指令，动态更新 UI