servers - 网页与API类MCP服务器

使用说明

项目简介

'servers' 仓库是 Model Context Protocol (MCP) 服务器的参考实现集合，由 Anthropic 维护并与社区共同构建。该仓库旨在展示 MCP 的多功能性和可扩展性，演示如何使用 MCP 为大型语言模型 (LLM) 提供安全、受控的工具和数据源访问能力。

主要功能点

资源 (Resources) 访问: 通过 MCP 协议向 LLM 客户端提供对各种数据资源的标准化访问，例如：
- 文件系统 ('filesystem'): 安全的文件操作，支持配置访问控制。
- Google Drive ('gdrive'): 访问和搜索 Google Drive 文件。
- PostgreSQL ('postgres'): 只读数据库访问，支持模式检查。
- ...等等
工具 (Tools) 注册与执行: 集成多种实用工具，允许 LLM 调用外部功能，例如：
- 网络搜索 ('brave-search', 'fetch'): 使用 Brave Search API 进行网页和本地搜索，抓取网页内容。
- 代码仓库操作 ('github', 'gitlab', 'git'): GitHub, GitLab API 集成，Git 仓库操作。
- 数据库交互 ('postgres', 'sqlite'): PostgreSQL, SQLite 数据库交互能力。
- 浏览器自动化 ('puppeteer'): 浏览器自动化和网页抓取。
- ...等等
Prompt 模板 (Prompts): 部分服务器提供 Prompt 模板，例如 'everything' 服务器，用于演示可定制的 LLM 交互模式。
多种传输协议支持: 通过 JSON-RPC 协议与客户端通信，并支持 Stdio, SSE, WebSocket 等多种传输协议。

安装步骤

该仓库本身是参考实现的代码仓库，无需安装。每个服务器都是独立的包，可以单独安装和运行。

以 Brave Search 服务器为例：

确保已安装 Node.js 和 npm: 如果未安装，请先安装 Node.js (包含 npm)。

安装 Brave Search 服务器: 打开终端，运行以下命令安装 Brave Search 服务器包：

npx -y @modelcontextprotocol/server-brave-search

'-y' 参数表示自动确认安装。

以 Git 服务器为例 (Python服务器):

确保已安装 Python 和 pip: 如果未安装，请先安装 Python (建议 Python 3.8+)。
安装 Git 服务器: 打开终端，运行以下命令安装 Git 服务器包：
```
pip install mcp-server-git
```
或使用 'uvx' (推荐):
```
uvx mcp-server-git
```
如果未安装 'uvx'，请参考 uvx 安装指南安装。

服务器配置

MCP 服务器是为 MCP 客户端 (例如 Claude Desktop) 提供的后端服务。配置 MCP 服务器主要是在 MCP 客户端中设置服务器的启动命令和参数。

以 Claude Desktop 配置 Brave Search 服务器为例 (JSON 格式):

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "<YOUR_BRAVE_API_KEY>"
      }
    }
  }
}

配置参数说明:

'server name': 'brave-search' (服务器名称，用户自定义，用于在客户端配置中标识服务器)
'command': 'npx' (命令，用于执行 Node.js 包，这里用于启动 Brave Search 服务器)
'args': '["-y", "@modelcontextprotocol/server-brave-search"]' (参数列表，传递给 'npx' 命令。 '-y' 表示自动确认安装，'@modelcontextprotocol/server-brave-search' 是 Brave Search 服务器的 npm 包名)
'env': '{ "BRAVE_API_KEY": "<YOUR_BRAVE_API_KEY>" }' (环境变量，用于设置服务器运行所需的环境变量。 'BRAVE_API_KEY' 需要替换为你在 Brave Search API 申请的实际 API 密钥)

不同服务器的配置请参考仓库 README.md 或各服务器目录下的 README.md 文件。 通常需要根据服务器的功能配置不同的 'args' 和 'env'。例如 'filesystem' 服务器需要指定允许访问的目录路径，'github' 和 'gitlab' 服务器需要配置 API Token 等。

基本使用方法

启动 MCP 服务器: 根据服务器的安装说明，在终端运行相应的启动命令。例如 Brave Search 服务器使用 'npx -y @modelcontextprotocol/server-brave-search'。
配置 MCP 客户端: 在 MCP 客户端 (例如 Claude Desktop) 中，按照上述 "服务器配置" 部分的说明，配置已启动的 MCP 服务器。确保配置的 'command' 和 'args' 与实际服务器的启动方式一致，并正确设置了必要的环境变量 (例如 API 密钥)。
在 LLM 中使用工具和资源: 连接成功后，LLM 客户端即可通过 MCP 协议与服务器通信，并使用服务器提供的工具 (Tools) 和资源 (Resources)。具体使用方式取决于 LLM 客户端的功能和界面。

以 Brave Search 服务器为例: 配置完成后，在 Claude Desktop 中，你可以指示 Claude 使用 'brave_web_search' 或 'brave_local_search' 工具进行网络或本地搜索。例如，你可以提问 "使用 brave_web_search 搜索最新的 AI 新闻"。

关键词