模型上下文协议仓库

欢迎来到模型上下文协议（Model Context Protocol，简称 MCP）的官方仓库。MCP 是一个开放协议，用于连接和管理大型语言模型 (LLM) 的工具和服务。这个仓库包含了多种现成的 MCP 服务器实现，并提供了如何使用和扩展这些服务器的详细指南。

项目背景

模型上下文协议 (MCP) 是一个开源协议，旨在统一和简化 LLM 工具的开发和集成。通过 MCP，开发者可以轻松地将各种工具（如文件系统、数据库、版本控制系统等）连接到他们的 LLM 应用程序中。

这个仓库由 Anthropic 管理，并且得到了社区的广泛支持。我们鼓励每个人为 MCP 仓库贡献自己的服务器实现或改进意见！

仓库内容

现成的 MCP 服务器

本仓库提供了多种现成的 MCP 服务器实现，包括：

• Memory: 提供对内存数据的访问。
• FileSystem: 提供对文件系统的访问。
• Git: 提供与 Git 版本控制系统交互的能力。
• GitHub: 提供与 GitHub API 的集成。
• Postgres: 提供 PostgreSQL 数据库的连接。

更多服务器实现正在开发中，欢迎关注我们的更新！

使用指南

使用本仓库中的 MCP 服务器

TypeScript 基础的服务器

TypeScript 基础的服务器可以直接使用 npx 运行。例如，运行以下命令可以启动 Memory 服务器：

npx -y @modelcontextprotocol/server-memory

Python 基础的服务器

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 客户端

单独运行一个服务器并没有太大意义，通常我们会将服务器配置到一个 MCP 客户端中使用。例如，以下是 Claude Desktop 配置文件示例：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-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"]
    }
  }
}

创建 MCP 服务器

如果你希望为 MCP 协议实现一个新的服务器，可以参考以下步骤：

1. 了解 MCP 协议: 阅读 MCP 协议文档 以获取详细的技术规范。
2. 选择开发语言: 根据你的需求选择 TypeScript 或 Python 作为开发语言。
3. 实现服务器逻辑: 根据协议 specification 实现具体的服务器功能。
4. 测试和验证: 使用我们的测试框架对新服务器进行全面测试，确保其兼容性和稳定性。
5. 提交到仓库: 如果你希望将你的服务器加入本仓库，请按照 贡献指南 提交代码。

贡献说明

我们非常欢迎社区的贡献！无论你是开发者、技术爱好者还是开源项目维护者，都可以为 MCP 协议的发展贡献力量。请参考 贡献指南 了解如何加入我们的开发团队。

安全注意事项

• 漏洞报告: 如果你发现任何安全漏洞，请通过 安全邮件列表 联系我们。
• 依赖管理: 确保你的项目中使用的第三方库都是最新版本，并且没有已知的安全问题。

许可证

本仓库中的代码遵循 MIT License 协议。具体许可条款请参考 LICENSE 文件。

欢迎加入模型上下文协议的社区，与我们一起推动 LLM 工具和应用的发展！