Learning about MCP

了解 MCP

TODO：

• 实现采样 https://modelcontextprotocol.io/docs/concepts/sampling

• 实现根目录。

学习心得

• 有两种传输方式：

  • 通过 stdio。在这里，你需要提供客户端可使用的服务端二进制文件路径。

  • 通过 sse。在这里，你需要提供服务端的网络地址。

    • 在我看来，这种传输方式似乎更通用。它允许服务端独立于客户端进行部署。

• 我_真的_很想用 fastify 来构建服务端，但没能让它与现有的 SDK 配合工作。

  • 这是一个很好的机会，可以学习如何_仅_使用 Node 编写这样的服务端！

• 与 MCP 相关的核心原语包括：

  • 资源——可以把它们看作数据（例如 PDF、数据库记录等），客户端可以用它们来组织内容，从而针对用户的查询生成恰当的回复。

  • 提示词——可以把它们看作预定义的提示词，有时会出现在“prompt to x”工作流的文本框下方。

  • 工具——它们允许大模型代表用户执行操作。由服务端调用工具，并将结果回复给客户端。客户端的工作是将结果传递给大模型。

  • 采样——说实话，我还不确定它们是什么。

  • 根目录——它们定义了服务端的“边界”。例如，如果服务端公开了一个操作文件系统的工具，你可以将特定目录添加到“根目录”中，这样工具的操作范围就只限于该目录。

  • 传输——上文已经介绍过。传输方式包括 STDIO 和 SSE。至于消息，则通过 JSON-RPC 2.0 格式化。

• 我真的很喜欢 SDK 内置错误处理这一点。

  • 我可以在服务端的 tool 回调函数中抛出错误，客户端 SDK 会处理错误并作出相应响应。