用途:帮助在构建或修改基于 mcp-use 的应用时,按需定位到对应参考文档,覆盖工具、资源、提示词、可视化组件、认证与部署等实现主题。该内容是导航式指南,主张先读概览判断相关性,再阅读具体功能对应参考文件,并应用其中的详细模式,而非仅依赖本文件中的极简示例。
主要能力与结构:先判断是否已处于 mcp-use 项目,检测依据为 package.json 是否列出 mcp-use 依赖,或是否存在从 mcp-use/server 导入的 .ts 文件。若已有项目则不重新脚手架,直接进入快速导航添加功能;若无项目则先脚手架。脚手架命令为:npx create-mcp-use-app my-server,随后 cd my-server 与 npm run dev。
导航主题包括:基础概念与架构、快速上手、部署;认证部分的概览及 WorkOS、Supabase、自定义提供商;服务端后端部分包含 tools、resources、prompts、response-helpers、proxy;可视化组件部分包含 basics、state、interactivity、ui-guidelines、advanced;此外还有常见完整示例与决策树。
文中列出的原则与限制:工具用于动作、资源用于只读数据、提示词用于模板、组件用于界面;建议先用模拟数据原型。常见反模式包括直接返回原始对象、缺少 Zod 字段描述、缺少输入校验、直接抛错而非使用 error()、组件未检查 isPending、硬编码密钥、缺少缓存与 CORS 配置等。还给出若干规则,如一工具一能力、提前返回完整数据、组件自管状态、exposeAsTool 默认 false、仅在边界校验。
适用场景:需要为 mcp-use 应用添加工具、资源、提示词、组件、认证或部署能力时。限制:资料未提供具体版本、收费、价格、平台细节与完整效果说明。