关于 Model Context Protocol Resources & Guides
这是面向工程师的 MCP 技术指南与实践资源,涵盖协议机制、版本演进及服务器构建。项目还介绍 TypeScript 框架 mcp-ts-core 及配套的编码 Agent 技能。
主要功能
- 01讲解 MCP 角色与消息格式
- 02梳理传输、授权与安全
- 03对比旧版和现代服务器
- 04提供服务器构建设计技能
- 05列出维护者的服务器与端点
适用场景
- 01在阅读规范前建立 MCP 概念模型
- 02规划服务器的工具与资源
- 03检查工具定义和响应设计
- 04审查服务器安全问题
MCP 相关
该项目介绍 MCP 规范及其实践,并提供供 MCP 服务器构建者使用的指南和 Agent Skills。其提及的 mcp-ts-core 是用于构建 MCP 服务的 TypeScript 框架。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Model Context Protocol (MCP)
截至 2026-07-28 规范的协议技术概述。
MCP 概述介绍了 MCP 的工作方式:各方角色、线上格式、服务端公开的内容、服务端如何请求输入、传输方式、授权,以及协议在 2026-07-28 版本中转为无状态后有哪些变化。本文面向希望先建立协议整体认知、再阅读规范的工程师。
要构建服务端? @cyanheads/mcp-ts-core 是一个基于当前规范构建 MCP 服务的 Agent 原生 TypeScript 框架。每个脚手架都附带 Agent Skills,编码 Agent 可遵循这些技能来设计、测试和发布服务端,并且服务端同时兼容旧版和现代客户端。使用以下命令搭建项目:
bunx @cyanheads/mcp-ts-core init my-mcp-server
在寻找可用的服务端? 我维护的服务端列于我的 GitHub 个人主页。Fleet Map 列出所有托管服务端及其工具、端点和安装命令片段。
指南
| 指南 | 涵盖内容 |
|---|---|
| MCP 概述 | 主机、客户端和服务端;消息与无状态性;工具、资源和提示词;多轮往返请求;通知和缓存;stdio 和 Streamable HTTP;授权;扩展;安全性 |
| 旧版与现代服务端 | 从 2024-11-05 开始的版本历史、2026-07-28 中的变化、弃用项、不同协议时代的兼容性与检测,以及面向服务端作者的迁移清单 |
面向服务端构建者的 Agent Skills
这些技能随 mcp-ts-core 一同发布,专为编码 Agent 编写。它们引用了该框架的 API,但其实践经验适用于任何 SDK。将其中一项技能交给你的 Agent,并让它为你的技术栈提炼相关指导。
| 你想要…… | 技能 |
|---|---|
| 设计 MCP 服务端:为某个领域或 API 规划工具接口、资源和服务层 | design-mcp-server |
| 构建优质工具:命名、架构、响应设计、错误处理 | add-tool |
| 审查工具描述和架构对模型而言是否清晰易读 | tool-defs-analysis |
| 设计大型或复杂的响应:溢出处理、载荷整形、检索模式 | techniques |
| 使用真实输入(包括对抗性输入)测试服务端 | field-test |
| 检查服务端的安全漏洞:提示词注入、输入接收点、身份验证、数据泄露 | security-pass |
官方资源
| 资源 | 链接 |
|---|---|
规范(2026-07-28) | modelcontextprotocol.io/specification/2026-07-28 |
| 此修订版本的变更日志 | 主要变更 |
| 已弃用功能注册表 | 已弃用 |
| Schema(事实来源) | schema.ts |
| 扩展 | 扩展概览 |
| 增强提案 | SEPs |
| 服务注册表 | MCP 注册表 |
| 调试 | MCP Inspector |
官方 SDK:TypeScript · Python · Go · Java · Kotlin · C# · Rust · Swift · Ruby · PHP
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。