MCP Server Learning

🚀 学习 MCP 协议

本项目聚焦于学习 MCP 协议，深入探索其各项特性与实现方式，为后续开发工作奠定坚实基础。

✨ 主要特性

• 涵盖两种传输方式，满足不同场景需求。
• 内置错误处理功能，增强系统稳定性。
• 定义了一系列核心 primitives，便于数据处理与交互。

📦 待办事项

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

📚 学习要点

传输方式

存在两种传输方式：

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

服务器搭建尝试

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

核心 primitives

与 MCP 相关的核心 primitives 包括：

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

错误处理功能

SDK 中内置了错误处理功能。如果在服务器 tool 回调函数中抛出一个错误，客户端 SDK 将会处理该错误，并做出相应的响应。这一特性大大提升了系统的稳定性和可靠性。