MCP 官方参考服务器发布 1.0.0：四个 npm 包与三个 Python 包同时转正

modelcontextprotocol/servers 于 2026 年 10 月 11 日发布 v1.0.0（GitHub Release published_at 为 2026-10-11T02:40Z）：everything、filesystem、memory、sequential-thinking 四个 npm 包同步到 1.0.0，fetch、git、time 三个 Python 包同步发布 2026.10.10。修订集中在会话生命周期、文件写行为与并发安全，而不是新增能力。

这次发布的是什么

modelcontextprotocol/servers 是 MCP（Model Context Protocol）官方维护的参考服务器仓库。2026 年 10 月 11 日，该仓库打出 v1.0.0 正式版 Release（GitHub Release 的 published_at 为 2026-10-11T02:40:29Z，非预发布），一次性把七个包推到稳定的主版本号：

• @modelcontextprotocol/server-everything 1.0.0（npm）
• @modelcontextprotocol/server-filesystem 1.0.0（npm）
• @modelcontextprotocol/server-memory 1.0.0（npm）
• @modelcontextprotocol/server-sequential-thinking 1.0.0（npm）
• mcp-server-fetch 2026.10.10（PyPI）
• mcp-server-git 2026.10.10（PyPI）
• mcp-server-time 2026.10.10（PyPI）

这四个 npm 包与三个 Python 包在发布后核对过注册表：npm 上四个包的 latest 均为 1.0.0，PyPI 上三个包的最新版本均为 2026.10.10，与 Release 正文的清单一致。需要说明的是，这些包是参考实现——用来演示协议怎么写、以及作为自己写 MCP 服务器的起点，不等于官方替你做好的生产服务。

可用性与限制

• 定位限制：它们是参考实现，主线目的是示范与起步参考；是否直接用于生产环境需要自己评估，官方对运行保障的承诺以仓库说明为准。
• 运行环境：npm 包需要 Node 运行环境，Python 包需要 Python 运行环境，具体最低版本以各包的包管理声明为准。
• 文件系统边界：filesystem 服务器只能在允许的目录范围内操作；roots 未就绪时工具调用会等待初始 roots，没有任何允许目录时会明确报错而不是静默失败。
• 跨平台差异：尽管 CI 已在 Windows runner 上跑测试，Unicode 路径、UNC 共享路径等边界仍以官方文档为准。
• 版本会漂移：命令名、工具名与行为随版本调整，本文描述基于 v1.0.0 的发布正文。

主要功能

• everything：会话断开时清理订阅；端口已被占用时 SSE 明确报「port already in use」，而不是照常输出「Server is running」；未知会话在 Streamable HTTP 上返回 404；支持按流重放（per-stream replay），关闭时一并关闭会话；异步任务工具限制在各自的客户端任务内；工具的资源按服务器隔离；instructions 只在具备对应能力时才列出相应工具，表单模式下的 elicitation 请求也受闸门控制；动态 blob 资源标注为 application/octet-stream；发布包不再携带编译后的测试与 vitest 配置。
• filesystem：正确解析只在 Unicode 形式上与磁盘不同的路径（含 macOS 场景）；放行位于 UNC 共享根目录允许范围内的路径；工具调用前等待初始 roots；每个工具的 schema 声明 JSON Schema 2020-12；edit_file 保留行尾与缩进；可以原地覆盖已存在的文件；补齐 zod 的运行时依赖声明。
• memory：拒绝悬空的关系；JSONL 输出补上尾随换行；MEMORY_FILE_PATH 中以 ~ 开头的路径展开到家目录；不再报告并未实际发生的删除；从磁盘加载时校验知识图谱条目；限制 search_nodes 的查询长度；同一批次内跳过重复的实体与关系；把图变更串行化以避免并发写竞争；跨进程对图文件加锁，两个进程共用一个文件时两边的写入都能保住；保存时保留文件权限位，只读文件直接拒绝；保存时保留读不懂的行而不是丢掉。
• sequential-thinking：readOnlyHint 与 idempotentHint 置为 false；正确处理以 Object.prototype 键名命名的 branchIds，失败时保持状态不变；thought log 头部不再出现 undefined，边框按可见文本宽度计算。
• Python 三件套（fetch / git / time）：在 serverInfo 中上报包版本号；CI 引入与 TypeScript 侧对齐的 Python 检查（validate:py 与 ruff）；补上协议级特征测试。
• 发布工程：TypeScript 服务器改用 changesets 管理版本，并由 GitHub Release 触发发布。

技术原理

从发布正文能确认的事实是：这次变更绝大多数是「把协议的正确写法补齐」，集中在三类边界上。

第一类是传输层的会话生命周期。everything 服务器的改动串起来看，就是说清楚了一个会话从建立、重连、重放到关闭的全过程：重复或未知的会话要被回答而不是被忽略，未知会话在 HTTP 上要给 404，流要能按条重放，服务关闭时要真的把会话关掉，会话断开时要连带清理订阅。这些在单次调试里往往看不出差别，但在客户端反复重连、或者同一个端口被重复占用的场景里，差别就出来了。

第二类是数据落盘的并发安全。memory 服务器这一批改动最密集：加载时校验、写入时加锁、串行化变更、遇到读不懂的行保留而不是丢弃、权限位原样保留。合起来的效果是「两个进程写同一个记忆文件不会互相覆盖，一行坏数据不会带走整张图」。

第三类是工具可见性。everything 与 sequential-thinking 都动了 hints 与 instructions：工具是否在 instructions 里出现，取决于当前能力是否真的开启；不具备写幂等性的工具不再标成幂等。这决定了模型「看得到什么工具」，而不是工具本身能做什么。

至于为什么七个包能同一时刻对齐版本号，正文里给的直接答案是 changesets + GitHub Release 触发发布，以及把待发布的 changeset 汇总成 1.0.0 的 CHANGELOG。

实际体验

可以按下面几步自己验证，全程不需要真实业务数据：

1. 用 npm view @modelcontextprotocol/server-filesystem version 确认当前拉到的版本号，核对是否为 1.0.0。
2. 用官方 Inspector 连一个参考服务器，读它的 instructions，确认里面列出的都是当前能力已开启的工具。
3. 对 everything 在同一个端口上启动两次，观察是否明确报端口占用，而不是照常提示服务已运行。
4. 给 memory 传一个以 ~ 开头的 MEMORY_FILE_PATH，确认路径被展开到家目录，文件确实落在那里。
5. 用 filesystem 对一个已存在的文件做写入（跑之前先备份），确认是原地覆盖而不是新文件或报错。
6. Python 包用 pip 安装后，连上去看 serverInfo 里是否返回了正确的版本号。

如果任何一步的行为与上文描述不符，先确认拉到的是不是 v1.0.0 对应的版本，再回到官方 Release 正文与文档核对。

项目地址与获取方式

Release 页面：https://github.com/modelcontextprotocol/servers/releases/tag/v1.0.0

仓库：https://github.com/modelcontextprotocol/servers

npm 包：@modelcontextprotocol/server-everything、@modelcontextprotocol/server-filesystem、@modelcontextprotocol/server-memory、@modelcontextprotocol/server-sequential-thinking

PyPI 包：mcp-server-fetch、mcp-server-git、mcp-server-time

请通过官方仓库与官方包管理渠道获取，安装前核对包名拼写，避免装到名字相近的第三方包。是否有额外的费用或额度限制，以官方说明为准，本文不转述任何价格。

适合谁用

• 刚开始写自己的 MCP 服务器、想找一份官方写法的开发者。
• 已经在跑 MCP 客户端（编辑器、桌面应用、自研智能体）的人，这次的会话与覆盖范围修订会直接影响你们的联调表现。
• 维护 Python 侧服务器的人：CI 与包版本上报这一轮补齐后，排查问题更容易。
• 不适合：想找「开箱即用的生产级 MCP 服务」的人——参考实现不承担这层责任，需要自己加固。
• 不适合：只想连一次看看效果的用户——这些包的价值在源码与修订记录里，不在开箱即用的界面上。

常见问题

1.0.0 是不是意味着 MCP 协议本身升级到了 1.0？

这次 1.0.0 标的是 modelcontextprotocol/servers 这个参考服务器仓库里的包版本。发布正文中确实出现了「release audit for the SDK 1.x release branch」这样的表述，但协议版本的演进有独立的规范页面。两者是否同步，以官方规范与官方 SDK 仓库的发布说明为准，本文不替它们下结论。

我在旧版本上跑的自定义服务器需要立刻升级吗？

看你们用到了哪些传输能力。参考实现的修订不强制追随：如果你的客户端仍能正常握手与调用，就不必跟着动。是否迁移、迁移后有无破坏性改动，以各包 CHANGELOG 与官方迁移说明为准。

为什么四个 npm 包的版本号是 1.0.0，三个 Python 包却是 2026.10.10？

两侧用了不同的版本号习惯，Python 包采用的是日期形式的版本。这是发布清单里直接给出的版本号，各自的版本策略细节以官方仓库为准。

filesystem 会改动我的文件吗？

会。这一轮明确支持原地覆盖已存在的文件，并且操作限定在允许的目录范围内。拿真实目录做验证前请先备份。

这批参考服务器与 OpenAI SDK 的分页改动是一回事吗？

这次 Beta 分页上限与非空参数对齐的改动出现在 OpenAI 官方 SDK 一侧（见本批另两篇快讯），与这批参考服务器不是同一件事。

相关工具与内容

• 分类：AI 智能体、AI 编程
• 同题材快讯：FastMCP 4.0.11 安全修复
• 同题材快讯：Docker Agent v1.149.0 发布
• 延伸阅读：智能体与网页搜索配置
• 工具页：Cursor、Claude Code、Cline、Dify