MCP Server Learning

🚀 学习 MCP 协议

本项目聚焦于学习 MCP 协议，涵盖待办事项与学习要点，助你深入了解 MCP 协议的相关知识与实现方法。

📋 待办事项

• 实现采样方法：https://modelcontextprotocol.io/docs/concepts/sampling
• 实现根目录。

📚 学习要点

传输方式

存在两种传输方式：

• 通过 stdio：你需要提供一个服务器二进制文件的路径，供客户端使用。
• 通过 sse：你需要提供服务器的网络地址。这种传输方式似乎更加通用，它允许服务器独立于客户端部署。

服务器搭建尝试

原本想使用 fastify 搭建服务器，但无法使其与现有 SDK 配合使用。不过，这也是一个学习仅使用 Node.js 编写服务器的好机会！

MCP 相关核心 primitives

• 资源：可以将其视为数据（如 PDF、数据库记录等），这些数据可用于根据用户查询塑造正确的响应。
• 提示：可将其视为有时在“提示到 x”流程中看到的文本框下方定义的提示语句。
• 工具：这些允许 LLM 代表用户执行操作。服务器负责调用工具并使用结果向客户端做出响应，客户端的任务是将这些结果传递给 LLM。
• 采样：目前对这些还不是很确定。
• 根目录：它们定义了服务器的“边界”。例如，如果你的服务器暴露了一个与文件系统交互的工具，你可以通过在“根目录”中包含特定目录来将该工具“限制”在此目录内。
• 传输方式：前面已提到，存在 STDIO 和 SSE 两种传输方式。至于消息格式，则是基于 JSON - RPC 2.0 协议的。

SDK 错误处理

SDK 中内置了错误处理功能。如果在服务器 tool 回调函数中抛出一个错误，客户端 SDK 将会处理该错误，并做出相应的响应。