安装
npx @modelcontextprotocol/inspector适合谁
当你要创建高质量 MCP(Model Context Protocol)服务器,让模型通过设计良好的工具调用外部 API 或服务时,使用 mcp-builder。语言可以是 Python(FastMCP)或 Node/TypeScript(MCP SDK)。它是一份构建指南,不是替你托管未点名的服务器。
更合适的前提是:你愿意先做深入调研和规划,而不是一上来就写接口。资料把 TypeScript 写成 SDK 支持更好、在多种执行环境(例如 MCPB)兼容性更好的选择。资料没有给出代理产品名单或仓库安装路径。官方说明页是
https://raw.githubusercontent.com/anthropics/skills/main/skills/mcp-builder/SKILL.md
3 分钟完成第一次尝试
这条说明没有给出 skill 安装命令,第一次不要编造路径。推荐路径从第一阶段开始:Deep Research and Planning。高质量 MCP 服务器有四个主要阶段,摘录只完整写出第一阶段标题,因此第一次只做规划,不写服务进程。
前置:你已经有一个要接入的外部 API 或服务。低风险动作:列出该服务有哪些只读查询、哪些会改数据,并决定远程用 Streamable HTTP。摘要还提到本地可用 stdio,但摘录只写了远程的 Streamable HTTP,因此第一次不要假设 stdio 参数已经写全。
成功信号:一页纸能说清「给模型哪些工具、输入用什么约束」。不要先 npm init 一个未规划的项目。规划确认后再进入实现;TypeScript 侧可用 Zod 做输入 schema,字段要有约束、清楚描述,并在字段描述里加例子。写文件前先确认目录。
使用案例
案例一:按 TypeScript 推荐栈规划一个远程服务器。选定 MCP SDK,传输用 Streamable HTTP,输入用 Zod,描述里带约束和例子。摘要还提到 outputSchema/structuredContent,以及 readOnlyHint、destructiveHint 等注解,但摘录没有写出这些字段的完整示例,因此本案例完成标准是规划里区分只读与会改数据的工具,而不是已经填好全部注解。不要同时起一套 Python 作为「主路径」;Python FastMCP 与 Pydantic 是并列选项,不是必须双写。
案例二:实现之后做编译与检查。TypeScript 路径是先 npm run build 确认能编译,再用 MCP Inspector:npx @modelcontextprotocol/inspector。Inspector 会开检查界面,属于有副作用的步骤,先确认要测的是你刚构建的本地或远程服务器,再执行。完成标准是 build 通过,并且 Inspector 能连上你指定的服务。摘录没有写出 Inspector 的全部旗标,因此不要编造连接参数。
使用边界
四个主要阶段从深入调研与规划开始;后续摘要概括为实施再检查测试,但其余阶段标题未在摘录展开。远程传输写明 Streamable HTTP。输入 schema 用 Zod 或 Pydantic。TypeScript 检查命令是 npm run build 与官方 Inspector。
不要编造仓库内安装路径。资料没有给出客户端名单,也没有写如何跳过规划直接发布。超出这些已写明的阶段、语言选项和检查命令,这份说明覆盖不到。