agentmentoragentmentor

Sources

S1 — MCP Introduction

URL: https://modelcontextprotocol.io/docs/getting-started/intro

  • 权威: 官方文档
  • 支撑: MCP 的总体目的、host/client/server 关系、server 暴露上下文和能力的基本模型。
  • 关键事实: MCP 用标准方式把 AI applications 接到外部 tools、data sources、prompts 等上下文。

S2 — Build an MCP Server

URL: https://modelcontextprotocol.io/docs/develop/build-server

  • 权威: 官方文档
  • 支撑: 官方入门路线,先创建 server,再暴露 tool/resource/prompt。
  • 关键事实: 官方教程以实际 server 构建为主线,适合作为本课 v1.x 入门路径的主要依据。

S3 — MCP SDKs

URL: https://modelcontextprotocol.io/docs/sdk

  • 权威: 官方文档
  • 支撑: 各语言 SDK 的共同能力边界。
  • 关键事实: SDK 支持创建暴露 tools、resources、prompts 的 server,也支持构建 client 和本地/远程 transport。

S4 — MCP TypeScript SDK

URL: https://github.com/modelcontextprotocol/typescript-sdk

  • 权威: 官方文档
  • 支撑: TypeScript SDK 包、server 注册工具/资源/提示、stdio/HTTP transport、路径安全提示和 v2 pre-alpha 状态。
  • 关键事实: 2026-06-30 读取时,main 分支 README 标注 v2 仍处 pre-alpha,并提示 v1.x 仍是生产推荐版本直到 v2 稳定发布。

S5 — MCP Base Protocol Overview

URL: https://modelcontextprotocol.io/specification/2025-03-26/basic

  • 权威: 官方文档
  • 支撑: MCP 消息层与 JSON-RPC 2.0、请求/响应/通知结构。
  • 关键事实: MCP 基础协议要求消息遵守 JSON-RPC 2.0,并把 base protocol、lifecycle、server/client features 分层。

S6 — MCP Tools Specification

URL: https://modelcontextprotocol.io/specification/2025-11-25/server/tools

  • 权威: 官方文档
  • 支撑: tool 的用途、发现和调用方式。
  • 关键事实: Tools 是 server 暴露的 model-controlled 可执行能力,client 可以 list 和 call。

S7 — MCP Lifecycle Specification

URL: https://modelcontextprotocol.io/specification/2025-11-25/basic/lifecycle

  • 权威: 官方文档
  • 支撑: initialize、operation、shutdown 和 capability negotiation。
  • 关键事实: MCP 连接生命周期包括 initialization、operation、shutdown,初始化阶段协商协议版本和能力。

S8 — MCP Inspector Documentation

URL: https://modelcontextprotocol.io/docs/tools/inspector

  • 权威: 官方文档
  • 支撑: Inspector 是用于测试和调试 MCP server 的交互式工具。
  • 关键事实: Inspector 可用于连接 server、查看 tools/resources/prompts、调试请求和响应。

S9 — MCP Inspector GitHub Repository

URL: https://github.com/modelcontextprotocol/inspector

  • 权威: 官方文档
  • 支撑: Inspector 的运行命令、默认 UI/proxy 端口、导出 host 配置能力。
  • 关键事实: Inspector 默认运行 client UI 和 proxy,并支持用 npx @modelcontextprotocol/inspector <server command> 连接本地 server。

S10 — Reference MCP Servers

URL: https://github.com/modelcontextprotocol/servers

  • 权威: 官方文档
  • 支撑: 真实 server 的参考入口,供学习者在本课后继续对照。
  • 关键事实: 官方维护 reference/community server 仓库,可作为 server 形态和配置的后续参考。

S11 — A Taxonomy of Runtime Faults in Model Context Protocol Servers

URL: https://arxiv.org/abs/2606.05339

  • 权威: 权威教程/书
  • 支撑: MCP server 真实运行故障会集中在协议交互、tool invocation、schema、state、security、timeouts 等层。
  • 关键事实: 该论文分析了大量 MCP runtime fault 线程,把常见故障归纳为多类运行问题,支撑本课最后一节的调试分层思路。