SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场build-mcp-use-server

build-mcp-use-server

编程与开发

查看项目

更新于 10-16 02:21

技能介绍

用途

本技能用于构建、修改、调试或验证基于 mcp-use v2 的 TypeScript MCP 服务器与 ChatGPT Apps。其核心目标是让开发者以已安装的 mcp-use 包、其导出类型、生成的声明文件（mcp-env.d.ts）以及官方文档（docs.mcp-use.com）作为权威依据，并确保每个使用 mcp-use 构建的 ChatGPT 应用默认符合 OpenAI Apps SDK UI（@openai/apps-sdk-ui）规范。

主要能力

技能以官方 MCPServer API 为基础，采用官方 mcp-use skills 的简洁架构，覆盖以下主题：

  • 服务器：工具、资源、提示、中间件、请求上下文、结果信封与 ServerConfig。
  • 视图（Views）：MCP Apps、React hooks、交互通道、宿主能力与 CSP。
  • OpenAI Apps SDK UI 指南：全部 29 个组件、hooks、Tailwind 4 配置、设计令牌与主题同步。
  • ChatGPT 插件扩展：启动入口（global、thread、file）、原生 server.settings()、工具图标、useDeepLink() 与 useModelContext()。
  • 认证：OAuth 提供方适配器、mixedAuth: true、工具级 securitySchemes 与 ctx.auth 上的已验证身份。
  • Skills over MCP：skills/ 目录下的可复用智能体工作流与约定。
  • 高级特性：OpenAPI（fromOpenAPI）、代理、通知、订阅与交互式 elicitation（inputRequired）。
  • 多主机与 Archestra：部署到 ChatGPT、Claude Desktop 与 Archestra（已安装服务器路线与自有应用）。
  • 迁移：将旧版 v1 模式、已弃用导入与过时辅助函数升级到 v2。
  • 验证：使用 mcp-use typecheck、mcp-use dev、mcp-use client 与 mcp-use screenshot 的验证循环。

使用方式

工作流程如下：

  1. 检查项目：查看 package.json、服务器入口、导出的工具引用、views/、skills/ 以及已安装的 mcp-use 版本（要求 Node.js >= 22.22.2）。
  2. 脚手架或初始化：全新项目使用官方 CLI 脚手架：
npx create-mcp-use-app@latest my-app --template mcp-apps

（无头工具服务器使用 --template mcp-server。）

  1. 阅读聚焦参考：服务器、视图、OpenAI Apps SDK UI 指南、ChatGPT 插件扩展、认证、Skills over MCP、高级特性、多主机与 Archestra、迁移等章节。
  2. 基于已安装类型实现：始终导出静态工具引用并默认导出服务器实例。
  3. 确定性验证：通过 mcp-use client 驱动真实工具调用，并使用 mcp-use screenshot 捕获视图截图。

核心不变量包括：从 "mcp-use" 根路径导入 MCPServer 与服务器原语（旧版 "mcp-use/server" 子路径已废弃）；导出每个工具引用（export const myTool = server.tool(...)）；默认导出服务器实例（export default server;）；使用 server.tool(definition, callback) 定义工具，工具参数使用 inputSchema，模型提示使用 schema；工具回调必须返回原始 CallToolResult 信封，不使用已弃用的 v1 辅助函数；每个视图放在 views/<name>/view.tsx，且每个视图必须有唯一属主工具与强制 outputSchema；ChatGPT 应用必须安装 @openai/apps-sdk-ui、导入其 CSS、配置 Tailwind 4 @source，并用 <AppsSDKUIProvider linkComponent="a"> 包裹交互组件；服务器实例按请求作用域，禁止使用模块全局变量或内存会话注册表；v2.7.2+ 严格 CLI 布尔标志语法；禁止使用已移除的 v1 ctx.elicit()。

适用场景

适用于需要使用 mcp-use v2 与 MCPServer 构建 TypeScript MCP 服务器、开发带界面的 ChatGPT Apps（含 Views、Plugin 扩展）、集成 OpenAI Apps SDK UI、配置认证与多主机部署，以及从 v1 迁移到 v2 的场景。也适用于需要通过 mcp-use typecheck、dev、client、screenshot 进行确定性验证的开发流程。

限制

暂无其他明确限制信息。需注意 Node.js 版本要求 >= 22.22.2；旧版 v1 模式、"mcp-use/server" 子路径、ctx.elicit() 与 v1 辅助函数（text()、object()、widget()）已废弃或移除，需按 v2 方式实现。