Mindket
中级免费

MCP 实战课:写、测试并接入 MCP 服务器

黑色横幅,标题是“MCP 实战课”,下面一行写着“用 Python 或 TypeScript 写 MCP 服务器,测试并接入”。

这是一门免费的 MCP 教程,教你用官方 SDK 以 Python 或 TypeScript 写出 MCP 服务器,用 MCP Inspector 测试,再接入 Claude Desktop、Cursor 和 VS Code。全课共四节动手课,所有命令和配置都抄自官方文档。你需要会一点 Python 或 TypeScript,并且会用终端。

学完你能做到

  • 用官方 SDK 写出能运行的 Python MCP 服务器,再用 TypeScript 写一遍。
  • 注册工具,参数结构来自 Python 的类型注解或 Zod,并让 stdout 保持干净,协议才不会被破坏。
  • 在 MCP Inspector 里测试任何服务器,浏览器或命令行都行,并读到一次调用背后的 JSON-RPC 消息。
  • 用正确的配置文件、顶层键和绝对路径,把本地服务器接入 Claude Desktop、Cursor 和 VS Code。
  • 读各个应用的日志,找出服务器连不上的原因。
全部课程

适合谁

适合熟悉 Python 或 TypeScript 和终端、想自己写 MCP 服务器的开发者。你需要 Python 3.11 或更高,或者 Node.js 20 或更高,Inspector 还需要打过补丁的 Node.js:22.23.4、24.22.1 或 26.12.1,或者各自系列里更新的版本。想先弄懂协议本身,可以先读 Mindket 上讲什么是 MCP 的文章。

课程内容

  1. 1用官方 SDK 写一个 Python MCP 服务器用官方 SDK 写一个 Python MCP 服务器:用 uv 安装,写两个工具,通过 stdio 运行,再到 MCP Inspector 和 Claude Desktop 里验证。6 分钟
  2. 2用官方 SDK 写一个 TypeScript MCP 服务器用官方 SDK 写一个 TypeScript MCP 服务器:搭好项目,用 Zod 定义工具的参数,通过 stdio 提供服务,再到 Inspector 里调用它。5 分钟
  3. 3MCP Inspector:测试和调试 MCP 服务器学会用 MCP Inspector:对本地或远程服务器启动它,在浏览器里调用工具,查看协议日志,再用命令行模式做同样的检查。9 分钟
  4. 4把 MCP 服务器接入 Claude Desktop、Cursor 和 VS Code把 MCP 服务器接入 Claude Desktop、Cursor 和 VS Code:每个应用的配置文件、JSON 格式、怎样重新加载,以及没有出现时该去哪里查。7 分钟

常见问题

这门 MCP 课程免费吗?

免费。四节课都可以免费阅读,里面的每条命令和配置都抄自官方文档,来源列在每节课的末尾。

要同时会 Python 和 TypeScript 吗?

不用。第 1 课用 Python 写服务器,第 2 课用 TypeScript 写一个服务器。Inspector 和接入两节课对两种语言都适用,所以你可以用自己喜欢的语言学完整门课。

学完这门 MCP 课程要多久?

读完四节课大约半小时。写服务器和测试要花更久,取决于有多少代码是你自己敲的。

课程用的是哪个版本的 MCP SDK?

Python 的课用 SDK 2.x,服务器类叫 MCPServer。TypeScript 的课用 v2 系列的 @modelcontextprotocol/server 包。旧教程用的是 FastMCP 和 @modelcontextprotocol/sdk,抄代码之前先核对名字。

课程讲 Claude Code 吗?

接入那一课讲的是 Claude Desktop、Cursor 和 VS Code。Claude Code 在 Mindket 上有单独的指南,讲怎样给 Claude Code 添加 MCP 服务器。

分享这门课

看看已经有哪些现成的

写自己的服务器之前,先到 Mindket 上浏览 MCP 服务器。

浏览 MCP 服务器

全部课程 · 全部文章