使用说明

项目简介

mcp-servers 仓库提供了一系列基于 Model Context Protocol (MCP) 的服务器实现，旨在帮助开发者快速将外部服务（如 GitHub 和 Puppeteer）集成到大型语言模型 (LLM) 应用中。通过这些 MCP 服务器，LLM 可以安全、可扩展地访问外部数据和功能，从而实现更强大的应用场景。

主要功能点

• GitHub 集成: 提供访问 GitHub API 的能力，允许 LLM 应用进行代码仓库管理、Issue 跟踪、Pull Request 处理、代码搜索等操作。
• Puppeteer 集成: 提供 Web 浏览器自动化能力，允许 LLM 应用进行网页内容抓取、屏幕截图、页面导航、表单交互等操作，从而获取和操作网络信息。

安装步骤

1. 安装 Node.js 和 npm: 确保您的系统已安装 Node.js 和 npm 包管理器。

2. 获取 GitHub Personal Access Token (可选): 如果您需要使用 GitHub MCP 服务器，请提前在 GitHub 上创建 Personal Access Token 并妥善保管。

3. 安装 MCP 服务器: 使用以下命令安装所需的 MCP 服务器。

   # 安装 GitHub MCP 服务器
   npx -y @modelcontextprotocol/server-github
   
   # 安装 Puppeteer MCP 服务器
   npx -y @modelcontextprotocol/server-puppeteer
   

服务器配置

MCP 服务器需要通过 MCP 客户端进行配置才能使用。您需要在 MCP 客户端的配置文件中指定 MCP 服务器的启动命令和参数。以下是示例配置信息（JSON 格式），您需要将其添加到 MCP 客户端的 'mcpServers' 配置项中。

{
  "mcpServers": {
    "github": {
      "command": "npx",  // 启动服务器的命令，通常为 npx 或 node
      "args": [         // 命令参数
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {          // 环境变量
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-github-token" // GitHub Personal Access Token，请替换为您的 Token
      }
    },
    "puppeteer": {
      "command": "npx",  // 启动服务器的命令，通常为 npx 或 node
      "args": [         // 命令参数
        "-y",
        "@modelcontextprotocol/server-puppeteer"
      ],
      "env": {}          // 环境变量，Puppeteer 服务器通常不需要环境变量
    }
  }
}

基本使用方法

1. 配置 MCP 客户端: 将上述服务器配置信息添加到您的 MCP 客户端配置文件中。
2. 启动 MCP 客户端: 启动您的 MCP 客户端应用程序。客户端会根据配置自动启动和管理 MCP 服务器。
3. 通过 MCP 客户端调用功能: 在您的 LLM 应用中，通过 MCP 客户端向配置的服务器发送请求，即可使用 GitHub 和 Puppeteer 提供的功能。具体的调用方式请参考 MCP 客户端和各个 MCP 服务器的文档。

注意: 请将 'your-github-token' 替换为您实际的 GitHub Personal Access Token。