MCP官方参考实现合集发布

本仓库是 Model Context Protocol（MCP）的参考实现集合，同时也收录了社区构建的服务器及相关资源索引。

如果你想查找 MCP 服务器列表，可以浏览 MCP Registry 上已发布的服务。本 README 所对应的仓库只包含 MCP 指导小组维护的少量参考服务器。

本仓库中的服务器旨在作为参考实现，用于展示 MCP 的功能特性和 SDK 的使用方法。它们是供开发者构建自有 MCP 服务器时参考的学习示例，而非生产级解决方案。开发者应根据自身的安全需求，基于具体的威胁模型和使用场景实现相应的防护措施。

本仓库中的服务器展示了 MCP 的多样性和可扩展性，演示了如何利用 MCP 为大语言模型（LLM）提供安全、受控的工具和数据源访问能力。通常，每个 MCP 服务器都基于一个 MCP SDK 实现：

这些服务器旨在展示 MCP 功能及官方 SDK 的用法。

Everything - 包含 prompts、resources 和 tools 的参考/测试服务器。

Fetch - 用于高效 LLM 使用的网页内容获取与转换。

Filesystem - 配有过滤器访问控制的安全文件操作。

Git - 用于读取、搜索和操作 Git 仓库的工具。

Memory - 基于知识图谱的持久化记忆系统。

Sequential Thinking - 通过思维序列实现的动态、反思式问题解决。

Time - 时间和时区转换功能。

以下参考服务器已归档，可前往 servers-archived 目录查阅：

• AWS KB Retrieval - 使用 Bedrock Agent Runtime 从 AWS Knowledge Base 检索内容。
• Brave Search - 使用 Brave Search API 进行网页和本地搜索。已被官方服务器（@brave/brave-search-mcp-server）替代。
• EverArt - 使用多种模型生成 AI 图片。
• GitHub - 仓库管理、文件操作和 GitHub API 集成。
• GitLab - GitLab API，支持项目管理。
• Google Drive - Google Drive 文件访问和搜索能力。
• Google Maps - 位置服务、路线规划和地点详情。
• PostgreSQL - 只读数据库访问，支持 schema 检查。
• Puppeteer - 浏览器自动化和网页抓取。
• Redis - 与 Redis 键值存储交互。
• Sentry - 从 Sentry.io 获取和分析问题。
• Slack - 频道管理和消息功能。现由 Zencoder 维护。
• SQLite - 数据库交互和商业智能能力。

使用本仓库中的 MCP 服务器

本仓库中基于 TypeScript 的服务器可直接通过 npx 使用。

例如，启动 Memory 服务器：

npx -y @modelcontextprotocol/server-memory

本仓库中基于 Python 的服务器可直接通过 uvx 或 pip 使用。推荐使用 uvx，操作更简便。

例如，启动 Git 服务器：

# 使用 uvx
uvx mcp-server-git

# 使用 pip
pip install mcp-server-git
python -m mcp_server_git

按这些指引安装 uv / uvx，按这些指引安装 pip。

然而，单独运行一个服务器并没有太大用处，应该将其配置到某个 MCP 客户端中。例如，以下是将上述服务器配置到 Claude Desktop 的方式：

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

在 Windows 上，用 cmd /c 包裹 npx：

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

更多使用 Claude Desktop 作为 MCP 客户端的配置示例如下：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
    },
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "path/to/git/repo"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    }
  }
}

在 Windows 上，对上述每个基于 npx 的条目应用相同的包装：将 "command" 改为 "cmd" 并在现有 args 前添加 "/c", "npx"。uvx 条目保持不变。

🛠️ 创建你自己的服务器

想创建自己的 MCP 服务器？访问官方文档 modelcontextprotocol.io，那里有关于实现 MCP 服务器的综合指南、最佳实践和技术细节。

参阅 ADDITIONAL.md 获取精选的框架和资源列表，这些工具可以简化 MCP 服务器和客户端的构建。

参阅 CONTRIBUTING.md 了解如何为本作贡献代码。

参阅 RELEASING.md 了解包是如何发布的（通过 CI 中的 OIDC trusted publishing，无需注册表 token）以及如何重试失败的发布。

参阅 SECURITY.md 了解如何报告安全漏洞。

新贡献采用 Apache License Version 2.0，现有代码采用 MIT 协议——详见 LICENSE 文件。

如果你觉得 MCP 服务器很有用，请考虑给仓库点个星，或者贡献新的服务器或改进！

本项目由 Anthropic 管理，但与社区共同构建。Model Context Protocol 是开源的，我们鼓励每个人贡献自己的服务器和改进！