Model Context Protocol Servers

🚀 模型上下文协议（Model Context Protocol）

模型上下文协议 (MCP) 是一个开源项目，旨在为大型语言模型 (LLMs) 提供统一接口，以扩展其功能。借助 MCP，开发者能轻松将各类工具和服务集成到 LLM 中，让其执行更复杂的任务。

🚀 快速开始

模型上下文协议 (MCP) 为开发者提供了将各种工具和服务集成到大型语言模型 (LLMs) 中的便捷途径。以下是使用 MCP 的快速指南。

✨ 主要特性

• 为大型语言模型提供统一接口，便于扩展功能。
• 支持多种编程语言（如 Typescript、Python）的服务器运行。
• 可轻松将不同工具和服务配置到 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 服务器

上述已展示了如何使用 npx 运行 Typescript 基础服务器和使用 uvx 或 pip 运行 Python 基础服务器的示例。

在 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", "--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"]
    }
  }
}

📚 详细文档

如果您有兴趣创建自己的 MCP 服务器，可以访问官方文档 modelcontextprotocol.io 以获取全面的指南、最佳实践和技术细节。

🔧 贡献

有关如何为本仓库做贡献的信息，请参阅 CONTRIBUTING.md。

🔒 安全

有关报告安全漏洞的信息，请参阅 SECURITY.md。

📄 许可证

此项目根据 MIT 许可证发布，具体请参阅 LICENSE 文件。

👥 社区

• GitHub 仓库
• 讨论组
• 文档

通过模型上下文协议，我们可以更方便地将各种工具和服务集成到 LLM 中，从而提升其功能和应用场景。