用途：在构建或修改基于 mcp-use 的应用时提供导航式指南，涉及 MCP 工具、资源、提示、组件、鉴权与部署等关注点时，先读本文件确定相关参考文件，再阅读具体参考文件并应用其中的模式，不要仅依赖本文件中的最简示例。
主要能力与主题：基础概念（concepts、architecture、quickstart、deployment）；鉴权（overview、workos、supabase、custom）；服务端后端（tools、resources、prompts、response-helpers、proxy）；可视化组件（basics、state、interactivity、ui-guidelines、advanced）；完整示例（common-patterns）。决策树覆盖从新建项目、OAuth 鉴权、后端动作、只读数据、提示模板、可视化 UI 到部署的分支。
使用方式：先判断是否已在 mcp-use 项目中——检查 package.json 是否含 mcp-use 依赖或是否有从 mcp-use/server 导入的 .ts 文件；已存在则不要重新脚手架，直接按需添加功能；不存在（空目录或新项目）先脚手架：npx create-mcp-use-app my-server，cd my-server，npm run dev；若处于无关项目内而用户需要 MCP 服务器，先询问创建位置再脚手架，不要放在无关项目根目录。禁止手工创建 MCPServer 样板、package.json 或项目结构。
核心原则：工具用于动作，资源用于只读数据，提示用于模板，组件用于 UI；先做模拟数据。工具定义应使用响应助手（text()、object()、markdown()、widget()、error() 等），每个 Zod 字段加 .describe()，校验输入，用 error() 而非抛出错误。组件开发需检查 isPending，自行管理 UI 状态，包裹 McpUseProvider 并启用 autoSize，用 useWidgetTheme() 支持主题。安全与生产方面避免硬编码密钥、补上错误处理与缓存、配置 CORS。建议一工具一能力、一次返回完整数据、组件自持状态、仅在边界处校验、浏览或比较场景优先使用组件。exposeAsTool 默认 false，需按四步完成 schema 定义、元数据引用、类型推断与 useWidget 泛型以保留类型安全。
限制与缺失：具体部署细节、各提供商配置参数、版本与费用等信息需查阅对应参考文件；本资料暂未提供这些文件的具体内容。