MCP 服务器

Model Context Protocol (MCP) Tips and Best Practices

以下是一些使用模型上下文协议 (MCP) 服务器的技巧和最佳实践： (Yīxiē shǐyòng móxíng shàngxiàwén xiéyì (MCP) fúwùqì de jìqiǎo hé zuìjiā shíjiàn:) Alternatively, a more concise translation: 使用模型上下文协议 (MCP) 服务器的技巧和最佳实践 (Shǐyòng móxíng shàngxiàwén xiéyì (MCP) fúwùqì de jìqiǎo hé zuìjiā shíjiàn)

AndreaGriffiths11

开发者工具

访问服务器

README

模型上下文协议 (MCP) 提示与最佳实践

什么是 MCP？

模型上下文协议 (MCP) 是一种使 AI 模型能够与开发环境和工具进行通信的协议。它允许 AI 助手以结构化和安全的方式收集上下文、执行命令以及更改代码库。 MCP 服务器充当 AI 模型和开发环境之间的中介，为交互提供标准化接口。

设置指南

前提条件

您的系统上已安装 Docker
具有适当权限的 GitHub 个人访问令牌 (PAT)
带有必要扩展的 VS Code

基本设置步骤

环境配置
- 将您的 GitHub 令牌设置为环境变量：
```
export GITHUB_TOKEN=your_token_here
```
Docker 镜像
- MCP 服务器在 Docker 容器中运行
- 官方镜像可在以下位置获取：ghcr.io/github/github-mcp-server

VS Code 设置

在您的 VS Code settings.json 中配置 MCP 服务器

基本配置示例：

{
  "mcp": {
    "servers": {
      "github": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "GITHUB_PERSONAL_ACCESS_TOKEN=${env:GITHUB_TOKEN}",
          "ghcr.io/github/github-mcp-server"
        ],
        "env": {
          "GITHUB_PERSONAL_ACCESS_TOKEN": "$GITHUB_TOKEN"
        }
      }
    }
  }
}

配置提示

最佳实践

令牌安全
- 永远不要将您的 GitHub 令牌提交到版本控制
- 使用环境变量来存储敏感信息
- 定期轮换您的 PAT 以确保安全
Docker 配置
- 使用 --rm 标志在容器停止后自动删除它们
- 考虑使用卷挂载来实现持久数据存储
- 保持您的 Docker 镜像更新到最新版本
VS Code 集成
- 保持您的 VS Code 和扩展更新
- 适当地配置日志记录级别
- 在需要时使用特定于工作区的设置

故障排除

常见问题和解决方案

连接问题
- 验证 Docker 是否正在运行
- 检查您的 GitHub 令牌是否有效并已正确设置
- 确保与 GitHub 的网络连接正常
身份验证问题
- 验证您的 PAT 是否具有所需的 scopes
- 检查环境变量配置
- 确保令牌未过期
Docker 相关问题
- 如果遇到镜像问题，请清除 Docker 缓存
- 检查 Docker 日志以获取详细的错误消息
- 验证 Docker 是否具有足够的系统资源
VS Code 集成问题
- 如果需要，将 VS Code 设置重置为默认值
- 检查 VS Code 的扩展日志
- 验证 settings.json 中的 MCP 配置语法