使用说明

项目简介

all_servers 仓库是 Model Context Protocol (MCP) 服务器的参考实现集合，旨在展示 MCP 的多功能性和可扩展性。这些服务器演示了如何使用 MCP 协议，使大型语言模型 (LLM) 能够安全且受控地访问各种工具和数据源。仓库中的每个 MCP 服务器都使用 Typescript MCP SDK 或 Python MCP SDK 实现。

主要功能点

丰富的服务器示例: 提供了包括 AWS 知识库检索、Brave 搜索、文件系统操作、Git/GitHub/GitLab 集成、Google Drive/Maps 访问、数据库 (PostgreSQL, SQLite) 交互、浏览器自动化 (Puppeteer) 等多种功能的参考服务器。
官方和社区服务器: 除了参考服务器外，还收录了第三方公司提供的官方集成 MCP 服务器以及社区开发的服务器，覆盖了广泛的应用场景。
框架和资源: 提供用于简化 MCP 服务器和客户端开发的框架，以及丰富的 MCP 相关资源链接，方便用户进一步学习和开发。
易于上手: 提供了使用 'npx' 和 'uvx'/'pip' 运行服务器的简易命令，以及 Claude Desktop 的配置示例，帮助用户快速开始使用。

安装步骤

本仓库本身不直接安装，而是作为 MCP 服务器参考实现的集合。每个服务器通常可以独立安装和运行。以下以 'memory' 服务器和 'git' 服务器为例说明安装步骤：

Typescript 服务器 (例如: memory)

确保已安装 Node.js 和 npm。

打开终端，运行以下命令即可启动 'memory' 服务器:

npx -y @modelcontextprotocol/server-memory

Python 服务器 (例如: git)

确保已安装 Python 和 pip 或 uvx (推荐)。
使用 uvx (推荐):
- 按照 uvx 安装指南安装 uv 和 uvx。
- 运行以下命令启动 'git' 服务器:
```
uvx mcp-server-git
```

使用 pip:

按照 pip 安装指南安装 pip。

运行以下命令安装 'git' 服务器:

pip install mcp-server-git

运行以下命令启动 'git' 服务器:

python -m mcp_server_git

服务器配置

MCP 服务器通常需要配置到 MCP 客户端中使用，例如 Claude Desktop。以下是一些服务器在 Claude Desktop 'claude-settings.json' 文件中的配置示例：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
      // 启动 memory 服务器的命令，无需额外参数
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
      // 启动 filesystem 服务器，并指定允许访问的文件路径
    },
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "path/to/git/repo"]
      // 启动 git 服务器，并指定 Git 仓库路径
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
        // 启动 github 服务器，并通过环境变量配置 GitHub Personal Access Token
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
      // 启动 postgres 服务器，并指定 PostgreSQL 数据库连接 URL
    }
  }
}

基本使用方法

选择服务器: 根据你的需求，选择合适的 MCP 服务器，例如需要进行网页搜索选择 'brave-search' 服务器。
安装和启动服务器: 按照对应服务器的说明进行安装和启动。
配置 MCP 客户端: 在 MCP 客户端 (如 Claude Desktop) 的设置中，配置已启动的 MCP 服务器信息，包括服务器名称、启动命令和参数。
在 LLM 中使用: 配置完成后，即可在 LLM 客户端中使用 MCP 服务器提供的工具、资源和 Prompt 模板，与外部数据和功能进行交互。具体使用方式请参考各个服务器的详细说明文档或示例。

注意: 社区服务器 (Community Servers) 标记为 untested 和 your own risk，使用时请谨慎。

关键词

使用说明

信息