modelcontextprotocol/servers

来源: https://github.com/modelcontextprotocol/servers

Model Context Protocol servers

本仓库收录了 Model Context Protocol (https://modelcontextprotocol.io/) (MCP) 的一系列参考实现，同时也收录了社区构建的服务器及额外资源的链接。

如果你在寻找 MCP 服务器列表，可以在 MCP Registry (https://registry.modelcontextprotocol.io/) 上浏览已发布的服务器。本 README 所对应的仓库仅用于存放由 MCP 指导小组维护的少量参考服务器。

本仓库中的服务器旨在作为参考实现，用于展示 MCP 的特性与 SDK 用法。它们是供开发者构建自己的 MCP 服务器时参考的教学示例，而非可直接用于生产的解决方案。开发者应根据自身的安全需求和特定的威胁模型及使用场景，评估并实现适当的安全防护措施。

本仓库中的服务器展示了 MCP 的灵活性与可扩展性，演示了如何利用 MCP 让大型语言模型 (LLM) 安全、受控地访问工具和数据源。

通常，每个 MCP 服务器都基于某个 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)

🌟 参考服务器

这些服务器旨在演示 MCP 的特性以及官方 SDK 的用法。

• Everything - 包含提示词、资源和工具的参考/测试服务器。
• Fetch - 网页内容抓取与转换，便于 LLM 高效使用。
• Filesystem - 安全的文件操作，支持可配置的访问控制。
• Git - 用于读取、搜索和操作 Git 仓库的工具。
• Memory - 基于知识图谱的持久化记忆系统。
• Sequential Thinking - 通过思维序列进行动态、反思性的问题求解。
• Time - 时间与时区转换功能。

已归档

以下参考服务器现已归档，可前往 servers-archived (https://github.com/modelcontextprotocol/servers-archived) 查看。

• AWS KB Retrieval (https://github.com/modelcontextprotocol/servers-archived/tree/main/src/aws-kb-retrieval-server) - 使用 Bedrock Agent Runtime 从 AWS Knowledge Base 中检索数据。
• Brave Search (https://github.com/modelcontextprotocol/servers-archived/tree/main/src/brave-search) - 使用 Brave 的 Search API 进行网页和本地搜索。已被官方服务器 (https://github.com/brave/brave-search-mcp-server)（@brave/brave-search-mcp-server (https://www.npmjs.com/package/@brave/brave-search-mcp-server)）所取代。
• EverArt (https://github.com/modelcontextprotocol/servers-archived/tree/main/src/everart) - 使用多种模型进行 AI 图像生成。
• GitHub (https://github.com/modelcontextprotocol/servers-archived/tree/main/src/github) - 仓库管理、文件操作以及 GitHub API 集成。
• GitLab (https://github.com/modelcontextprotocol/servers-archived/tree/main/src/gitlab) - GitLab API，支持项目管理。
• Google Drive (https://github.com/modelcontextprotocol/servers-archived/tree/main/src/gdrive) - Google Drive 的文件访问与搜索功能。
• Google Maps (https://github.com/modelcontextprotocol/servers-archived/tree/main/src/google-maps) - 位置服务、路线导航与地点详情。
• PostgreSQL (https://github.com/modelcontextprotocol/servers-archived/tree/main/src/postgres) - 只读数据库访问与 schema 检查。
• Puppeteer (https://github.com/modelcontextprotocol/servers-archived/tree/main/src/puppeteer) - 浏览器自动化与网页抓取。
• Redis (https://github.com/modelcontextprotocol/servers-archived/tree/main/src/redis) - 与 Redis 键值存储交互。
• Sentry (https://github.com/modelcontextprotocol/servers-archived/tree/main/src/sentry) - 从 Sentry.io 检索和分析问题。
• Slack (https://github.com/modelcontextprotocol/servers-archived/tree/main/src/slack) - 频道管理与消息功能。现由 Zencoder (https://github.com/zencoderai/slack-mcp-server) 维护。
• SQLite (https://github.com/modelcontextprotocol/servers-archived/tree/main/src/sqlite) - 数据库交互与商业智能功能。

🚀 快速开始

在本仓库中使用 MCP 服务器

本仓库中基于 TypeScript 的服务器可以直接通过 npx 使用。例如，以下命令会启动 Memory 服务器：

npx -y @modelcontextprotocol/server-memory

本仓库中基于 Python 的服务器可以直接通过 uvx (https://docs.astral.sh/uv/concepts/tools/) 或 pip (https://pypi.org/project/pip/) 使用。出于易用性和配置便利性考虑，推荐使用 uvx。例如，以下命令会启动 Git 服务器：

# 使用 uvx
uvx mcp-server-git

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

请按照这些 (https://docs.astral.sh/uv/getting-started/installation/) 步骤安装 uv / uvx，并按照这些 (https://pip.pypa.io/en/stable/installation/) 步骤安装 pip。

使用 MCP 客户端

不过，单独运行一个服务器并没有太大用处，应当将其配置到 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": ""
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    }
  }
}

在 Windows 上，请将上方每个基于 npx 的条目应用同样的包裹方式：将 "command" 改为 "cmd"，并在现有 args 前追加 "/c", "npx"。基于 uvx 的条目保持不变即可。

🛠️ 创建你自己的服务器

想创建自己的 MCP 服务器？请访问官方文档 modelcontextprotocol.io (https://modelcontextprotocol.io/introduction)，获取有关实现 MCP 服务器的全面指南、最佳实践和技术细节。

📚 进一步了解

参见 ADDITIONAL.md，了解一系列简化 MCP 服务器和客户端构建工作的框架和资源。

🤝 贡献

参见 CONTRIBUTING.md，了解有关向本仓库贡献的信息。

📦 发布

参见 RELEASING.md，了解软件包的发布方式（从 CI 进行 OIDC 可信发布——无需注册表令牌）以及如何重试失败的发布。

🔒 安全

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

📜 许可证

本项目对新的贡献采用 Apache License, Version 2.0，现有代码则采用 MIT 许可证——详情参见 LICENSE 文件。

💬 社区

• GitHub Discussions (https://github.com/orgs/modelcontextprotocol/discussions)

⭐ 支持

如果觉得 MCP 服务器有用，欢迎为仓库点星，并贡献新的服务器或改进建议！

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