MCP Servers 官方参考实现

项目概览

本仓库是 Model Context Protocol（MCP）的官方参考实现集合，由 MCP 指导组维护。它用一组小而精的服务器示例，演示如何让大语言模型（LLM）以安全、可控的方式访问工具与数据源。

注意：这里只保留少量官方参考服务器；完整的服务器列表请浏览 MCP Registry。仓库中的实现用于教学与演示，并非生产就绪方案。

参考服务器一览

部分历史服务器（GitHub、Slack、PostgreSQL、Puppeteer 等）已归档至 servers-archived 仓库，使用前请留意替代方案。

快速上手

TypeScript 服务器可直接用 npx 启动：

npx -y @modelcontextprotocol/server-memory

Python 服务器推荐用 uvx（或 pip）：

uvx mcp-server-git

单独运行服务器意义有限，通常需要把它配置进 MCP 客户端。以 Claude Desktop 为例：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

Windows 下需用 cmd /c 包裹 npx。

传输方式

MCP 定义两种标准传输：

• stdio：客户端以子进程方式启动服务器，通过标准输入输出通信，不开放端口；本仓库所有服务器均支持。
• Streamable HTTP：服务器作为独立 HTTP 服务运行，可服务多个客户端；目前仅 Everything 服务器同时支持。

多语言 SDK

每个服务器通常基于对应语言的 MCP SDK 实现，官方提供 C#、Go、Java、Kotlin、PHP、Python、Ruby、Rust、Swift、TypeScript 等 SDK，便于按团队技术栈选型。

使用建议

• 把本仓库当作学习模板：先跑通示例，再对照源码实现自己的服务器。
• 生产环境务必自行设计鉴权、沙箱与审计，结合具体威胁模型评估风险。
• 需要更多现成服务器时，优先检索 MCP Registry 与社区实现。