← 返回项目库

modelcontextprotocol/servers

servers:展示模型上下文协议参考实现与接入范式

该仓库汇集模型上下文协议的官方参考服务器,用于展示大模型如何通过工具、资源和提示接入文件、Git、网页、时间与持久记忆。适合学习协议、验证SDK用法或搭建自有服务器原型;主要门槛是自行评估权限与威胁模型,因为这些实现强调教学参考,并非可直接上线的成品。

官方名称:servers资料更新:2026/11/11
打开 GitHub
Stars
9.2万
7日增长
+140
Forks
1.2万
活跃度
100
维护状态
活跃

01WHAT IT SOLVES

这个项目解决什么问题?

这是由MCP指导组维护的少量官方参考服务器集合,定位不是通用服务目录,也不是生产级连接器市场,而是协议与官方SDK用法的可运行样本。仓库以Everything、Fetch、Filesystem、Git、Memory、Sequential Thinking和Time等服务,分别演示提示、资源、工具、权限控制、知识图谱记忆与结构化推理,并通过stdio或Streamable HTTP接入MCP客户端。它在同类方案中更像开发者的协议样板和测试基线:适合照着学习、改造和验证接口;若目标是开箱即用的业务集成,应转向MCP Registry中的已发布服务器或自行维护版本。

02CORE CAPABILITIES

核心能力

01

协议能力示例

通过Everything综合展示提示、资源和工具,并支持提示、资源集合及多种工具行为。

02

安全数据接入

Filesystem提供可配置目录权限和只读模式,Fetch负责网页内容获取与转换。

03

代码仓库操作

Git服务提供读取、搜索和操纵Git仓库的工具,并强化仓库边界约束。

04

持久记忆与推理示例

Memory使用知识图谱保存信息,Sequential Thinking展示分步反思式问题求解。

03适合谁

  • 正在学习或实现模型上下文协议开发者
  • 需要制作MCP服务器原型与教学示例的团队
  • 需要评估官方SDK接入方式和协议能力的开发者

04典型使用场景

  • 学习MCP服务器结构及官方SDK调用方式
  • 搭建文件、网页、Git仓库或时间转换工具原型
  • 验证MCP客户端与服务器的stdio或HTTP传输配置
  • 将参考实现改造成符合自身安全要求的内部服务

05为什么值得关注

  • 官方维护的参考实现可作为协议理解和开发调试的共同基线
  • 持续覆盖TypeScript、Python及多种官方SDK生态
  • 文件系统、Git和网页抓取等关键能力近期连续进行安全加固
  • 功能演进不仅涉及协议能力,也包括权限模型、传输方式和开发体验

06采用前要注意

  • 官方明确说明这些服务器用于教学参考,并非生产就绪方案
  • 采用前需要自行分析安全需求并按威胁模型增加防护措施
  • Node.js与Python环境版本会影响证书校验和包升级行为
  • 仓库只维护少量参考服务器,其他服务已归档或转由社区及第三方维护

07RELEASE INTELLIGENCE

近期版本变化

全部版本动态 →

servers v2.4.0:修复三组服务器安全漏洞

该版本集中修复Filesystem、Git和Fetch中的六项漏洞,涉及目录检查与符号链接竞态、Git配置命令执行、仓库越界访问及私网地址和robots.txt绕过。使用这些包的生产或测试环境应优先升级,并注意Filesystem在Windows上的竞态风险仅被部分收敛。

  • Filesystem升级至2.3.0,读取和移动操作被限制在已检查目录内
  • Git升级至2026.11.11,阻止仓库配置触发命令并拒绝越界对象与链接
  • Fetch升级至2026.11.11,补强IPv6私网识别和robots.txt路径检查
  • 从日期版本迁移时需手动安装新版,语义版本不会被包管理器自动视为更高版本

servers v2.3.0:扩展文件工具与参考能力

该版本发布Everything、Filesystem、Memory、Sequential Thinking、Fetch、Git和Time的新包版本,重点增强Everything的资源示例与HTTP运行模式,并为Filesystem增加追加、复制、只读、目录深度和文件资源等能力。依赖这些新接口的开发者可按需关注,普通参考用途则主要是了解协议演进。

  • Everything加入资源集合示例、Streamable HTTP模式及图标表现
  • Filesystem新增append_file、copy_file工具和可选目录树深度
  • Filesystem支持以file://模板暴露文件资源,并提供只读模式
  • 发布各服务器对应的新版本,同时修正若干文件搜索、符号链接和参数提示问题

servers v2.2.0:更新运行时与证书安全基线

该版本因中间CA证书私钥风险及Node.js、certifi安全问题,发布多语言服务器的新包版本。TypeScript服务依赖宿主Node.js证书环境,Fetch则依赖certifi;仍在使用旧运行时的部署需要主动升级或刷新环境,这是本次版本需要重点关注的兼容性事项。

  • TypeScript服务建议使用Node.js 24.22.1、26.12.1或更高版本
  • Fetch锁定并使用certifi 2026.10.23,旧环境需刷新依赖
  • Everything加强逐跳私网地址检查、环境凭据遮蔽和HTTP错误处理
  • Git与Time不发起网络连接,受本次证书更新影响相对有限

servers v2.1.0:集中修补八项安全漏洞

该版本修复Filesystem、Everything和Fetch中的八项漏洞,重点处理符号链接导致的目录越界、跨源调用工具、国际化域名与私网地址绕过,以及重定向后的robots.txt检查。涉及网络暴露、文件访问或不可信仓库的开发与部署人员应优先升级并复查安全配置。

  • Filesystem加强写入路径与实际使用路径的一致性检查
  • Everything的HTTP和SSE传输拒绝其他网页来源调用工具
  • Fetch修复IDNA主机名、NAT64地址及重定向后规则绕过
  • Windows上的Filesystem写入竞态仅部分修复,官方说明仍提供残余风险与规避建议

servers v2.0.0:迁移现代协议并兼容旧客户端

该版本将全部参考服务器重构到现代协议规范,同时保留对旧规范客户端的预期响应,并统一发布TypeScript与Python服务器的新包版本。TypeScript服务迁移至SDK v2并将Node.js最低要求提高到24;需要稳定使用现代协议能力或依赖新客户端行为的团队值得重点关注。

  • 全部参考服务器支持现代协议规范
  • 现代协议实现继续兼容旧规范客户端
  • TypeScript服务器迁移至SDK v2
  • TypeScript服务器Node.js最低版本提高至24,并完成依赖审计与修复

servers v1.0.0:发布最终旧时代服务器版本

本次发布是旧时代服务器系列的最终版本,纳入多项缺陷与安全修复,并继续发布四个TypeScript包和三个Python包。Everything补充会话清理、Streamable HTTP会话处理、异步任务归属和协议级测试,Filesystem增加Unicode路径测试并修正路径解析行为。发布说明未完整展示所有包的逐项记录,官方说明未提供更多细节。

  • 旧时代服务器系列以1.0.0版本收尾,汇总缺陷与安全修复
  • Everything改进会话资源隔离、异步任务归属和Streamable HTTP行为
  • Filesystem修正仅在Unicode形式不同的磁盘路径并补充相关测试
  • 四个TypeScript包与三个Python包均在该版本发布

servers 2026.8.31:四项参考服务同步更新

本次发布更新了 Filesystem、Memory、Sequential Thinking 与 Everything 四个 TypeScript 包。官方说明未提供更多细节,未说明具体功能变化、修复内容或升级影响,使用者应结合包版本变化与自身依赖进行核对。

  • Filesystem 更新至 2026.8.31
  • Memory 更新至 2026.8.31
  • Sequential Thinking 更新至 2026.8.31
  • Everything 更新至 2026.8.31

servers 2026.8.18:更新四项参考服务器包

本次版本更新了 Everything、Time、Fetch 与 Git 四个服务器包,其中前三者及 Git 的 Python 包均发布日期版本。官方说明未提供更多细节,未列出具体功能、修复或迁移要求;使用者应根据所依赖组件查阅包级变更记录。

  • Everything 更新至 2026.8.18
  • Time 更新至 2026.8.18
  • Fetch 更新至 2026.8.18
  • Git 更新至 2026.8.18

servers 2026.7.10:参考服务器滚动更新

Filesystem、Time、Fetch、Git 四个参考包同步更新至 2026.7.10。官方说明未提供更多细节,原文未披露节点版本或 SDK 调整细节,需查阅相应包的项目页或 commit 记录确认影响范围。

  • 官方说明未提供更多细节
  • 涉及 Filesystem(TS)、Time、Fetch、Git(PyPI)四个包

Model Context Protocol servers 2026.7.4:四款 TypeScript 参考服务器同步更新

本次将 everything、filesystem、sequential-thinking、memory 四个 TypeScript 参考服务器统一更新到 2026.7.4 版本,Python 端包未在本次发布中变动。影响基于这些参考服务器进行二次开发或跟版的开发者,建议核对升级影响。官方说明未提供更多细节。

  • server-everything、server-filesystem、server-sequential-thinking、server-memory 同步发布 2026.7.4
  • 仅涉及 TypeScript 端实现
  • Python 端参考服务器本批次未发布
  • 官方说明未提供更多细节