MCP参考服务器:让LLM受控访问文件、Git与网页数据
一组给MCP开发者参考的服务器示例,让LLM受控调用文件、Git和网页工具,不是生产成品。
GitHub modelcontextprotocol/servers 更新 2026-10-01 分支 main 星标 90.8K 分叉 11.7K
TypeScript Python Model Context Protocol LLM工具访问 Claude Desktop Dockerfile

🧭 决策指南

适合,如果你

  • 你要学习MCP prompts、resources和tools的组合实现
    README 的“Reference Servers”章节将Everything定义为包含prompts、resources和tools的参考/测试服务器
  • 你要在Claude Desktop中接入Memory或Filesystem
    README 的“Using an MCP Client”章节提供Claude Desktop的memory和filesystem配置示例
  • 你的MCP服务器使用TypeScript或Python SDK
    README列出TypeScript MCP SDK和Python MCP SDK,并说明TypeScript服务器可用npx、Python服务器可用uvx或pip
  • 你需要Git、网页抓取或时区能力的MCP示例
    README的参考服务器列表包含Git、Fetch和Time,并分别说明其功能

不适合,如果你

  • 你需要可直接承担生产流量的MCP服务器
    README的WARNING明确说明这些服务器是reference implementations,不是production-ready solutions
  • 你的安全要求无法由项目示例之外的自定义防护满足
    README的WARNING要求开发者根据自身security requirements、threat model和use case实现safeguards
  • 你要找完整的MCP服务器目录而不是少量官方参考实现
    README的IMPORTANT说明服务器清单应浏览MCP Registry,本仓库只维护少量MCP steering group参考服务器
  • 你需要已归档服务器的最新维护版本
    README的“Archived”章节说明AWS KB Retrieval、PostgreSQL、Puppeteer等服务器已迁移到servers-archived

前置条件

  • TypeScript服务器可直接使用npx;README示例命令为Memory的npx -y @modelcontextprotocol/server-memory。
  • Python服务器可使用uvx或pip,README明确推荐uvx以简化安装和设置。
  • 运行服务器应配置到MCP客户端;README以Claude Desktop的mcpServers配置作为示例。
  • Windows上的npx入口需要使用cmd /c包装,README明确要求将command改为cmd并在args前加入/c、npx。

第一步命令(README 原文)

npx -y @modelcontextprotocol/server-memory

要注意

  • 不要把Memory的npx示例直接当作生产部署方案
    README的WARNING明确说明仓库服务器不是production-ready solutions
  • Filesystem的访问控制仍需结合自身威胁模型补充防护
    README的WARNING要求开发者按specific threat model和use case实现appropriate safeguards
  • Git的Python启动方式需要在uvx与pip之间选择
    README的“Getting Started”同时给出uvx mcp-server-git、pip install mcp-server-git和python -m mcp_server_git
  • Windows配置npx服务器时不能照搬Linux的command字段
    README明确要求Windows使用cmd /c包装npx入口

替代方案

  • MCP Registry:你要浏览已发布的MCP服务器清单,而不是使用本仓库的少量参考服务器
    README 的IMPORTANT说明
  • Brave Search MCP Server:你需要Brave Search能力的当前官方服务器,而不是已归档的Brave Search参考服务器
    README 的Archived章节
  • servers-archived:你明确需要AWS KB Retrieval、PostgreSQL或Puppeteer等已归档示例
    README 的Archived章节

材料未说明

  • README没有说明各服务器支持的MCP协议版本与客户端兼容矩阵。
  • README没有给出Memory、Filesystem或Git的性能、资源占用和并发上限。
  • README没有列出每个参考服务器的测试覆盖率或生产故障记录。
  • README没有说明TypeScript与Python示例对应的具体运行时版本。
  • README没有提供各服务器完整的权限边界、数据隔离和审计实现细节。

💡 深度解析

6
不适合 我正在做 PostgreSQL、SQLite 或 Redis 的 MCP 原型,并希望所有服务器都由这个仓库统一维护;我能否直接依赖当前仓库中的这些连接器?
适合读者: 想接入已归档数据库连接器的原型开发者,当前使用 PostgreSQL、SQLite 或 Redis,并依赖仓库统一维护

不适合按当前仓库直接依赖,因为 README 明确说明 PostgreSQL、SQLite 和 Redis 已归档,不再属于当前参考服务器集合。

  • Archived 章节把 PostgreSQL 标为只读数据库访问、SQLite 标为数据库交互、Redis 标为键值存储交互,但链接均指向 servers-archived。
  • README 还强调本仓库只维护少量由 MCP steering group 维护的参考服务器,不是完整服务器目录。
  • 对 Brave Search、Slack 等项目,README 进一步显示部分能力已转由官方服务器或其他维护者负责,说明维护责任可能已经迁移。
  • 因此该仓库可用于理解 MCP 参考模式,但不能据此承诺这些数据库连接器仍在当前仓库发布、更新或接受统一支持。
  • README Archived:PostgreSQL、SQLite、Redis 均列在 archived servers
  • README:"small number of reference servers maintained by the MCP steering group"
  • README Archived:Brave Search 已被官方服务器替代,Slack 由 Zencoder 维护
  • README:"If you are looking for a list of MCP servers ... browse ... MCP Registry"
材料未说明:README 未说明归档服务器当前是否仍有可安装包、兼容版本或安全修复。;README 未说明 MCP Registry 中对应服务器的维护 SLA 和发布策略。
不适合 我们要把 Filesystem、Git 和 Memory 服务器接入多用户内部环境,而 README 只展示本地客户端启动;这个仓库能直接作为生产基础吗?
适合读者: 企业内部数据原型团队,需要把 MCP 服务器放入多用户或远程环境,而不是只在桌面进程中运行

不适合直接作为生产基础,因为 README 明确把这些服务器定义为参考实现,并要求使用者按自身威胁模型补充安全措施。

  • README 警告项目用于教育和展示 SDK 能力,不是 production-ready solutions。
  • Filesystem 的允许目录能展示范围控制,但不能替代多用户身份认证、租户隔离和审计体系。
  • 项目洞察指出本地进程启动更适合桌面或开发环境;远程、多用户和容器化部署需要额外设计认证、隔离、网络访问控制与日志审计。
  • 因此它适合作为协议和集成原型,不适合作为已经具备企业运维能力的连接器。
  • README WARNING:"not production-ready solutions"
  • README WARNING:"implement appropriate safeguards based on their specific threat model"
  • 项目洞察:远程、多用户、容器化环境需要额外认证、隔离、网络访问控制和日志审计
  • 项目洞察:Filesystem 通过允许目录展示路径范围控制
材料未说明:README 未定义多用户身份模型、租户隔离机制或服务器端审计格式。;README 未提供生产级 SLA、限流、故障恢复和长期兼容承诺。
适合 我使用 Python 和本地 Git 仓库,想通过 uvx 或 pip 启动 MCP Git 服务器;这个仓库能否减少安装和构建工作?
适合读者: 使用 Python 工具链维护 Git 辅助服务的开发者,需要让客户端读取本地 Git 仓库并避免手工构建包

适合,因为 README 为 Python Git 服务器提供了 uvx 和 pip 两条明确的启动路径。

  • README 直接说明 Python 服务器可通过 uvx 或 pip 使用,并推荐 uvx 以简化安装和设置。
  • Git 示例支持读取、搜索及操作 Git 仓库,与你的本地仓库约束匹配。
  • README 给出了可执行的 uvx mcp-server-git 命令,也给出了 pip 安装后用 Python 模块启动的方式。
  • 但仓库只说明服务器的启动方式,没有说明 Git 操作在不同仓库规模、子模块、凭证或写权限下的完整行为;这些边界不能从 README 推断。
  • Getting Started:"Python-based servers ... can be used directly with uvx or pip"
  • Getting Started:"uvx is recommended for ease of use and setup"
  • Getting Started:Git server 的 uvx、pip 和 Python 启动示例
  • 项目洞察:Git 服务器提供读取、搜索及操作 Git 仓库的工具
uvx mcp-server-git
材料未说明:README 未说明 Git 服务器要求的 Python 版本。;README 未说明 Git 写操作的具体范围、凭证处理方式和大仓库性能。
适合 我正在用支持 MCP 的客户端,并希望在 Node.js 环境中接入本地文件、Git 仓库和网页内容;这个仓库能否让我快速完成原型?
适合读者: 为 Claude 等 MCP 客户端接入本地文件、Git 和网页能力的个人开发者,需要在 Node.js 环境中直接启动服务器

适合,因为仓库提供可直接运行的参考服务器,并覆盖文件、Git 和网页等典型外部资源。

  • README 将项目定位为 MCP reference implementations,目标是展示 MCP 特性和 SDK 用法,而不是要求你从零实现协议。
  • TypeScript 服务器可通过 npx 启动;README 还明确提供 Memory 的可运行命令,启动路径较短。
  • Filesystem 服务器支持配置允许目录,Git 服务器面向本地仓库,Fetch 服务器负责抓取并转换网页内容。
  • 但这些实现不是生产就绪方案;接入真实数据前仍需自行处理认证、输入校验和更细的权限边界。
  • README:"collection of reference implementations"
  • Getting Started:"TypeScript-based servers ... can be used directly with npx"
  • 项目洞察:Filesystem、Git、Fetch 服务器分别覆盖本地文件、仓库和网页内容
  • README:"not production-ready solutions"
npx -y @modelcontextprotocol/server-memory
材料未说明:README 未说明目标 MCP 客户端的具体配置格式和兼容版本。;README 未说明 Fetch 对特定网站、登录态或反爬策略的兼容范围。
适合 我已经使用 TypeScript MCP SDK 开发服务器,想用一个官方维护的项目验证 tools、resources、prompts 和客户端发现流程;这个仓库是否合适?
适合读者: 维护 TypeScript MCP 服务器的应用开发团队,希望同时理解 tools、resources 和 prompts 的协议行为

适合,因为仓库中的 Everything 服务器正是用于集中展示 MCP 核心能力的参考实现。

  • README 说明每个服务器通常通过 MCP SDK 实现,并明确列出 TypeScript SDK,与你的技术栈直接对应。
  • 项目洞察指出 Everything 同时展示 prompts、resources 和 tools,适合验证能力发现、调用和上下文传递。
  • 服务器按独立目录拆分,便于将协议能力与具体实现隔离,并单独阅读或运行。
  • 需要注意,仓库是教学和协议参考集合,不是完整测试框架;README 没有承诺覆盖所有客户端生命周期、错误码或跨 SDK 行为。
  • README:"Typically, each MCP server is implemented with an MCP SDK"
  • README:TypeScript MCP SDK 列表
  • 项目洞察:Everything 服务器集中展示 prompts、resources 和 tools
  • README:"intended as reference implementations ... not as production-ready solutions"
材料未说明:README 未提供完整的 MCP conformance 测试矩阵。;README 未说明 TypeScript SDK 与你当前 SDK 版本之间的兼容范围。
视情况 我需要比较 TypeScript、Python、Go 和 Rust SDK 的 MCP 客户端互操作性;这个仓库能否作为完整的跨语言兼容性测试套件?
适合读者: 需要验证 MCP 客户端与多语言服务器互操作性的协议测试人员,覆盖 TypeScript、Python、Go 和 Rust SDK

视情况,因为仓库提供多语言 SDK 参考入口,但并未承诺完整的跨语言一致性或协议合规测试。

  • README 列出 C#、Go、Java、Kotlin、PHP、Python、Ruby、Rust、Swift 和 TypeScript SDK,适合建立比较范围。
  • 实际仓库主要由 TypeScript 和 Python 构成,项目数据分别为 490686 和 100153 字节代码量;这说明示例实现并非每种语言各有一套完整服务器。
  • 项目洞察指出不同 SDK 版本、运行时特性和具体服务器实现可能带来兼容性差异。
  • 因而它适合提供参考样例和互操作性起点,但不能单凭仓库结论覆盖所有客户端、生命周期和错误处理组合。
  • README:列出 C#、Go、Java、Kotlin、PHP、Python、Ruby、Rust、Swift、TypeScript SDK
  • 项目数据:TypeScript 490686、Python 100153
  • 项目洞察:跨语言实现可能因 SDK 版本、运行时特性和具体服务器行为产生差异
  • README:项目定位为 reference implementations
材料未说明:README 未提供跨语言互操作性矩阵或自动化 conformance 测试结果。;README 未说明各参考服务器对应的 SDK 版本和统一测试用例。

✨ 核心亮点

  • Everything同时展示MCP prompts、resources与tools
  • Filesystem提供可配置访问控制的安全文件操作
  • Git支持读取、搜索和操作Git仓库
  • TypeScript可用npx,Python可用uvx或pip运行
  • 仓库有90,815颗星,但仅维护10位贡献者

🔧 工程化

  • Memory用知识图谱提供持久化记忆,并可用npx启动
  • Fetch抓取并转换网页内容,面向LLM使用优化
  • Time处理时间及时区转换,Sequential Thinking支持思考序列

⚠️ 风险

  • README明确说明这些服务器不是生产就绪方案
  • README要求开发者按自身威胁模型实现安全防护
  • AWS KB Retrieval等服务器已移至servers-archived
  • 许可证为新贡献Apache-2.0、既有代码MIT的混合形式

👥 适合谁?

  • 需要学习MCP SDK和服务器实现的开发者
  • 使用Claude Desktop接入Memory或Filesystem的个人开发者
  • 需要TypeScript或Python参考代码的MCP集成团队