学会 MCP Server 基础

这门课教你把一个本地小能力包装成 MCP server,让 Codex、Claude Desktop、Cursor 等支持 MCP 的 host 能发现它、调用它、读取它提供的上下文。学完后,你不只是知道 MCP 是什么,而是能判断什么时候该写 tool、resource、prompt,并用官方 TypeScript SDK 做出一个能被 Inspector 调试的最小 server。

学完你将能(course objectives):

能解释 MCP host、client、server 三方各自负责什么。
能判断一个需求应该做成 tool、resource 还是 prompt。
能用 TypeScript SDK 写出一个 stdio MCP tool server。
能给 server 补上一个只读 resource 和一个可复用 prompt。
能用 MCP Inspector 做本地调试,并识别常见配置、schema、安全边界错误。

先修: 会打开终端、会运行 node/npm,读得懂一点 JavaScript 或 TypeScript。

练习环境: 你自己的终端、编辑器、Node.js 项目目录,再加一个支持 MCP 的 host 或 MCP Inspector。本课不内嵌沙盒。

课时表

节	主题	你将学会
01	MCP 不是又一个聊天 API	看清 host/client/server 的连接关系,判断一个 server 是否值得写
02	三种积木:tool、resource、prompt	把需求拆成可执行动作、可读取数据、可复用提示模板
03	写出第一个 TypeScript tool server	用官方 SDK 暴露一个最小可调用工具
04	给 server 加上下文和提示模板	添加 resource 与 prompt,避免把所有东西都塞进 tool
05	stdio、HTTP 和一次连接的生命周期	理解本地/远程 transport、initialize、capability negotiation
06	用 Inspector 调试到能交给 host	用 Inspector 验证工具、排查常见错误、整理交付配置

来源见 sources.md。