servers (MCP参考服务端实现)
91,937
Stars
0
Forks
0
Watchers
0
Open Issues
未知
许可证
TypeScript
语言
创建时间
最近更新
项目能做什么
Model Context Protocol(MCP)官方参考服务器实现库。
来源:AI 基于仓库事实生成
· 内容以仓库实际 README 为准
使用说明 查看原始 README 原仓库文档
{
"project_name": "modelcontextprotocol/servers",
"markdown": "## 项目简介\n\n`modelcontextprotocol/servers` 是 Model Context Protocol(MCP)官方指导小组维护的一组**参考实现(Reference Implementations)**仓库。该项目旨在通过具体的代码示例,演示如何使用各类官方 SDK 让大语言模型(LLM)安全、可控地访问外部工具和数据源。\n\n> **注意**:仓库内的 Server 属于教学演示性质的参考实现,**并非开箱即用的生产级解决方案**。开发者在构建自己的 MCP Server 时,需根据自身的安全需求与威胁模型增加防护机制。\n\n---\n\n## 核心功能\n\n仓库展示了多种官方 SDK(包括 C#、Go、Java、Kotlin、PHP、Python、Ruby、Rust、Swift、TypeScript)的用法,目前包含以下官方维护的参考 Server:\n\n- **Everything (`src/everything`)**:测试/全功能参考 Server,包含 Prompts、Resources 和 Tools 示例。\n- **Fetch (`src/fetch`)**:抓取网页内容并转换为适合 LLM 处理的格式。\n- **Filesystem (`src/filesystem`)**:支持访问控制的安全本地文件读写操作。\n- **Git (`src/git`)**:提供读取、搜索和操作 Git 仓库的工具。\n- **Memory (`src/memory`)**:基于知识图谱的持久化记忆系统。\n- **Sequential Thinking (`src/sequentialthinking`)**:通过动态和反思性的思考序列辅助复杂问题求解。\n- **Time (`src/time`)**:时间获取及跨时区转换工具。\n\n*(注:AWS KB Retrieval、Brave Search、GitHub、PostgreSQL、SQLite 等大量旧版 Server 已归档移至 `servers-archived` 仓库。)*\n\n---\n\n## 适合谁用\n\n- 正在学习 MCP 协议、准备基于 MCP SDK 开发自定义 Server 的开发者。\n- 需要现成代码参考以了解 MCP 工具(Tools)、资源(Resources)、提示词(Prompts)如何实现的开发者。\n\n---\n\n## 安装步骤\n\n可根据各 Server 的实现语言(TypeScript 或 Python)直接运行:\n\n### 1. TypeScript 实现的 Server\n可以使用 `npx` 直接免安装运行。以运行 Memory Server 为例:\n```sh\nnpx -y @modelcontextprotocol/server-memory\n```\n\n### 2. Python 实现的 Server\n推荐使用 `uvx` 直接免安装运行,也可以使用传统 `pip` 安装。以运行 Git Server 为例:\n\n**使用 uvx 启动(推荐):**\n```sh\nuvx mcp-server-git\n```\n\n**使用 pip 安装并启动:**\n```sh\npip install mcp-server-git\npython -m mcp_server_git\n```\n\n---\n\n## 配置说明\n\n此部分原文未详细说明各 Server 具体的配置文件结构及详细参数列表,请查看对应子目录(如 `src/filesystem`、`src/git` 等)的原仓库说明。\n\n---\n\n## 常见问题\n\n- **在哪里找更多可用的 MCP Server?** \n 本仓库仅保留官方 steering group 维护的少量参考实现。如果需要寻找社区公开发布的 Server 列表,请前往官方注册表 [MCP Registry](https://registry.modelcontextprotocol.io/) 浏览。\n- **这些 Server 可以直接上生产环境吗?** \n 不可以。官方明确警告这些仅为展示 SDK 用法的教学参考实现,上线生产需自行评估并补全安全措施。"
}
原始 README 摘录(英文原文,节选前 3000 字符)
# Model Context Protocol servers This repository is a collection of *reference implementations* for the [Model Context Protocol](https://modelcontextprotocol.io/) (MCP), as well as references to community-built servers and additional resources. > [!IMPORTANT] > If you are looking for a list of MCP servers, you can browse published servers on [the MCP Registry](https://registry.modelcontextprotocol.io/). The repository served by this README is dedicated to housing just the small number of reference servers maintained by the MCP steering group. > [!WARNING] > The servers in this repository are intended as **reference implementations** to demonstrate MCP features and SDK usage. They are meant to serve as educational examples for developers building their own MCP servers, not as production-ready solutions. Developers should evaluate their own security requirements and implement appropriate safeguards based on their specific threat model and use case. The servers in this repository showcase the versatility and extensibility of MCP, demonstrating how it can be used to give Large Language Models (LLMs) secure, controlled access to tools and data sources. Typically, each MCP server is implemented with an MCP SDK: - [C# MCP SDK](https://github.com/modelcontextprotocol/csharp-sdk) - [Go MCP SDK](https://github.com/modelcontextprotocol/go-sdk) - [Java MCP SDK](https://github.com/modelcontextprotocol/java-sdk) - [Kotlin MCP SDK](https://github.com/modelcontextprotocol/kotlin-sdk) - [PHP MCP SDK](https://github.com/modelcontextprotocol/php-sdk) - [Python MCP SDK](https://github.com/modelcontextprotocol/python-sdk) - [Ruby MCP SDK](https://github.com/modelcontextprotocol/ruby-sdk) - [Rust MCP SDK](https://github.com/modelcontextprotocol/rust-sdk) - [Swift MCP SDK](https://github.com/modelcontextprotocol/swift-sdk) - [TypeScript MCP SDK](https://github.com/modelcontextprotocol/typescript-sdk) ## 🌟 Reference Servers These servers aim to demonstrate MCP features and the official SDKs. - **[Everything](src/everything)** - Reference / test server with prompts, resources, and tools. - **[Fetch](src/fetch)** - Web content fetching and conversion for efficient LLM usage. - **[Filesystem](src/filesystem)** - Secure file operations with configurable access controls. - **[Git](src/git)** - Tools to read, search, and manipulate Git repositories. - **[Memory](src/memory)** - Knowledge graph-based persistent memory system. - **[Sequential Thinking](src/sequentialthinking)** - Dynamic and reflective problem-solving through thought sequences. - **[Time](src/time)** - Time and timezone conversion capabilities. ### Archived The following reference servers are now archived and can be found at [servers-archived](https://github.com/modelcontextprotocol/servers-archived). - **[AWS KB Retrieval](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/aws-kb-retrieval-server)** - Retrieval from AWS Knowledge Base using Bedrock Agent Runtime. - **[Brave Searc阅读完整原文
商业机会分析 AI 生成
生产级 MCP 安全鉴权与合规审计网关(MCP Security Gateway)
| 产品构想 | 针对 README 中明确提示的'非生产就绪、需自行评估安全威胁'痛点,构建轻量级 MCP 反向代理中间件,提供细粒度权限控制(RBAC)、工具调用审计日志、数据防泄漏(DLP)与速率限制。 |
| 核心功能 | 请求拦截与参数脱敏、调用行为鉴权与审批流、操作全量审计追踪、多环境 API Key 统一管理 |
| 目标用户 | 在企业内网接入 MCP 工具的架构师与安全合规团队 |
| 难度/周期 | 中等 · 1 - 2 个月 · 成本:低(基础云服务器开发测试) |
| 收费模式 | 核心网关开源,企业版/高级安全策略按月订阅,提供私有部署技术支持 |
| 竞争风险 | 官方协议或大厂未来可能在客户端或 SDK 侧原生加入基础鉴权,挤压纯工具层利润空间 |
| 依据 | 已验证事实 |
云端全托管 MCP Server 部署平台(Hosted MCP for AI Agents)
| 产品构想 | 解决目前大多数 MCP Server 需本地运行、配置繁琐的环境依赖问题,提供一键将公开或自定义 MCP Server 部署为高可用远程 HTTPS/SSE 服务的托管 PaaS,供 Claude Desktop、Cursor 等客户端远程调用。 |
| 核心功能 | 一键从 GitHub/NPM 部署 MCP Server、自动保活与冷启动优化、远程 OAuth 凭据安全存储、统一公网接入端点 |
| 目标用户 | 个人独立开发者、中小研发团队、非技术背景的 AI 客户端高级用户 |
| 难度/周期 | 中等 · 1 - 2 个月 · 成本:中等(Serverless 基础设施运营成本) |
| 收费模式 | 免费额度 + 资源用量阶梯计费(席位费/连接数/调用量) |
| 竞争风险 | 网络延迟可能影响实时交互体验;托管第三方代码存在容器安全与逃逸风险(推测) |
| 依据 | AI推测 |
企业专属数据源商业级 MCP 连接器定制与售卖
| 产品构想 | 官方已归档 Google Drive、GitLab 等泛用连接器并转向生态自建,可专攻企业高价值专有系统(如 SAP、Salesforce、Jira、私有数据库),提供满足生产 SLA 的商用 MCP Server 插件。 |
| 核心功能 | 复杂身份认证集成(SSO/OAuth2)、高并发只读/写入双通道、错误重试与长任务流式通知、现成企业系统数据模型映射 |
| 目标用户 | 推进企业内部 Agent 落地的技术总监(CTO/CIO)、数字化转型咨询公司 |
| 难度/周期 | 较高 · 2 - 3 个月 · 成本:低(主要为各企业软件开发者账号与联调测试成本) |
| 收费模式 | 商业许可授权买断(单 Connector)、年度更新维护费、定制集成咨询费 |
| 竞争风险 | 特定 SaaS 官方后续可能自行推出免费的官方 MCP Server(如 Brave Search 先例) |
| 依据 | 数据支持的判断 |
AI 基于仓库公开数据分析生成,含推测成分,不构成收益承诺。
报告会保存到 个人中心
竞品与相似项目 GitHub Search 真实检索
| 项目 | 中文简介 | Stars | 语言 |
|---|---|---|---|
| awesome-selfhosted/awesome-selfhosted | 可自建于个人服务器的自由开源网络服务与 Web 应用列表。 | 336,110 | - |
| fatedier/frp | 快速反向代理工具,助你将内网服务器安全暴露至公网。 | 110,539 | Go |
| punkpeye/awesome-mcp-servers | 精选的 MCP 服务器集合列表。 | 97,614 | - |
| headroomlabs-ai/headroom | 压缩工具输出、日志与 RAG 文本以减少 LLM Token 的库与服务。 | 79,364 | Python |
| caddyserver/caddy | 支持自动 HTTPS 的快速、可扩展多平台 HTTP/1-2-3 Web 服务器。 | 78,982 | Go |
| redis/redis | 高性能内存数据结构服务器,常用于缓存、文档与向量查询引擎。 | 77,435 | C |
以上为通过 GitHub 官方 Search API 检索的相似项目,功能差异与优劣势需进一步人工确认,配置 AI 后可生成对比分析。
项目优势与风险
| 技术成熟度 | 创建于 ,最近推送 ,发布过 33 个 Release |
| 社区活跃 | Star 91,937 / Fork 0 / Issue 0(数据支持,可自行核实) |
| 许可证 | 未检测到(需人工确认) |
| 主要风险 | 上游项目方向可能变化;同赛道竞争者较多(见竞品表);热度与需求不完全等价 |
安装与使用
快速开始(以仓库 README 为准)
git clone https://github.com/modelcontextprotocol/servers.git cd servers # 请阅读仓库 README 获取确切安装步骤(依赖、配置、启动命令)
术语说明:Docker=应用容器(把程序和依赖打包运行);API Key=调用外部服务的密钥;Git Clone=把仓库代码下载到本地。常见错误:API Key 未配置 / 端口占用 / 数据库连接失败,多数项目在 README 的 Troubleshooting 章节有说明。