理解 MCP 服务器概念
构建块 | 目的 | 由谁控制 | 真实世界示例 |
---|---|---|---|
工具 | 用于 AI 操作 | 模型控制 | 搜索航班、发送消息、创建日历事件 |
资源 | 用于上下文数据 | 应用程序控制 | 文档、日历、电子邮件、天气数据 |
提示 | 用于交互模板 | 用户控制 | “规划一次度假”、“总结我的会议”、“起草一封邮件” |
方法 | 目的 | 返回 |
---|---|---|
tools/list | 发现可用的工具 | 包含模式的工具定义数组 |
tools/call | 执行一个特定的工具 | 工具执行结果 |
searchFlights
查询多家航空公司并返回结构化的航班选项。选择航班后,它会使用
file:///path/to/document.md
。它们声明 MIME 类型以便进行适当的内容处理,并支持两种发现模式:具有固定 URI 的直接资源,以及具有参数化 URI 的资源模板。 资源模板通过 URI 模板实现动态资源访问。像 travel://activities/{city}/{category}
这样的模板可以通过替换 {city}
和 {category}
两个参数来访问过滤后的活动数据。例如,travel://activities/barcelona/museums
将返回巴塞罗那的所有博物馆。资源模板包含元数据,如标题、描述和预期的 MIME 类型,使其具有可发现性和自文档性。 协议操作:方法 | 目的 | 返回 |
---|---|---|
resources/list | 列出可用的直接资源 | 资源描述符数组 |
resources/templates/list | 发现资源模板 | 资源模板定义数组 |
resources/read | 检索资源内容 | 带有元数据的资源数据 |
resources/subscribe | 监控资源变化 | 订阅确认 |
calendar://events/2024
) - 用于检查可用时间file:///Documents/Travel/passport.pdf
) - 用于获取重要信息trips://history/barcelona-2023
) - 用户选择要遵循的过往旅行风格出发地
机场并开始输入“Bar”作为目的地
机场时,系统可以建议“Barcelona (BCN)”或“Barbados (BGI)”。
weather://forecast/{city}
输入“Par”可能会建议“Paris”或“Park City”方法 | 目的 | 返回 |
---|---|---|
prompts/list | 发现可用的提示 | 提示描述符数组 |
prompts/get | 检索提示详情 | 包含参数的完整提示定义 |
calendar://my-calendar/June-2024
(来自日历服务器)travel://preferences/europe
(来自旅行服务器)travel://past-trips/Spain-2023
(来自旅行服务器)