不想手撸 MCP Server 了？这个 Skill 让 Agent 一个人干完

写一个 MCP Server 还要到处抄代码？TypeScript 类型飘红、OAuth 流程怎么塞、View 视图怎么挂、Skills over MCP 怎么整——一堆新概念砸过来。mcp-use/mcp-builder 这个 Skill 就是来治这个的。

说白了，这是一个给 AI 编程 Agent 看的「mcp-use 框架权威指南」。它不教你写 Hello World，而是直接告诉 Agent：装 mcp-use 之后，先读 package.json 校对版本、然后按需加载 references/server.md、views.md、auth.md 几份子文档，再按「核心不变式」去写代码。Agent 拿到这份 Skill 后，会自己判断当前任务需要哪份参考资料，而不是一股脑把所有规范塞到上下文里。

它把工程纪律写得很死——比如：server API 必须从 mcp-use 导入、React API 必须从 mcp-use/react 导入、每个 View 必须放在 views/<name>/view.tsx、不要在模块全局存跨请求状态、不要相信客户端上报的 metadata。听起来很严，但反过来说——你再也不用担心不同 Agent 写出来的 MCP Server 风格五 1 ² 六了。

它解决了什么问题？

mcp-use 本身是个相当完整的 MCP 开发框架（10k+ stars），支持 tools/resources/prompts、MCP 中间件、身份认证、Skills over MCP、ChatGPT 风格的 MCP Apps/Views。但「完整」也意味着 API 表面大、坑多。直接让 Agent 写极易过度发挥——自己造 API、自己拼认证、最后跑不起来。

mcp-builder Skill 的核心价值是「提前画好红线」：

• 明确的硬规则：inputSchema 必须有、outputSchema 必须有、成功结果必须带 structuredContent、不要裸返回领域对象
• 路径约束：View 必须在 views/<name>/view.tsx，每个静态声明的 tool ref 必须 export—这些是 mcp-use dev/build/start 命令依赖的约定
• 分场景指引：OAuth 找 auth.md、可视化界面找 views.md、Skills over MCP 找 skills-over-mcp.md，不是把所有文档一股脑塞给 Agent
• 反例清单：不要用不存在的导出、不要为了兼容老代码保留已废弃的 API、不要只靠类型飘红就声称完成

对开发者来说，这个 Skill 让你写 MCP Server 时可以「Agent 主导、人 review」——而不是「人写一半、Agent 补一半」。

10 分钟上手

新项目直接用官方脚手架：

npx create-mcp-use-app@latest my-mcp-server
cd my-mcp-server
npm install
mcp-use dev      # 启动本地 Inspector 调试

然后让 Claude Code / Cursor / OpenCode 装上 mcp-builder Skill（Smithery 一键安装，或 npx skills add https://github.com/mcp-use/mcp-use），告诉它「帮我加一个查询天气的 tool」，它会按规范自己写好 tool 定义、输入校验、视图绑定、smoke test。

如果你已经在维护一个 MCP Server，Skill 里也写了迁移路径（references/migration.md），Agent 会自己识别老代码里那些 retired import、变化了的注册语法、过期 UI 模式。

整个仓库在持续更新（昨天刚提交），主题标签覆盖 agentic-framework、mcp、mcp-apps、mcp-server、skills 等等——是 mcp-use 生态目前最值得 follow 的官方 Skill。

GitHub 仓库：https://github.com/mcp-use/mcp-use/tree/main/skills/mcp-builder

GitHub: https://github.com/mcp-use/mcp-use/tree/main/skills/mcp-builder