本文详细介绍如何在 OpenCode 中配置 GitHub MCP Server，通过五个简单步骤实现 AI 助手与 GitHub 的深度集成，支持 Issue 管理、PR 操作、Actions 监控等丰富功能。

# 在 OpenCode 里使用 GitHub MCP Server 访问 GitHub

在现代开发工作流中，AI 助手与代码托管平台的深度集成已成为提升开发效率的关键。GitHub MCP Server 作为官方提供的 Model Context Protocol 实现，让 AI 助手能够直接与 GitHub 进行交互 —— 无论是管理 Issue、PR，还是搜索代码库、查看 Actions 状态。

本文将详细介绍如何在 OpenCode 中配置并使用 GitHub MCP Server，帮助你打造更智能的开发环境。

# 什么是 MCP？

Model Context Protocol（MCP） 是由 Anthropic 于 2024 年 11 月推出的开放标准，旨在标准化 AI 系统与外部工具、数据源的交互方式。在 MCP 出现之前，每个 AI 平台都需要为各种外部工具单独构建定制集成，而 MCP 充当了 AI 助手与第三方工具之间的标准化桥梁。

你可以把 MCP 理解为 AI 领域的「USB 接口」—— 无论是什么类型的设备（AI 助手），只要符合标准，就能直接连接各种外设（GitHub、数据库、文件系统等）。

# GitHub MCP Server 能做什么？

通过 GitHub MCP Server，你的 AI 助手可以获得以下能力：

📂 仓库浏览：读取代码文件、搜索提交记录、理解项目结构
🔧 Issue 管理：创建、更新、关闭 Issue，添加评论和标签
📝 PR 操作：创建和管理 Pull Request，添加审查意见
⚙️ Actions 监控：查看工作流状态，分析构建失败原因
🔒 安全告警：查看 Dependabot 警报、密钥扫描结果
💬 Discussions：管理社区讨论
📦 其他功能：访问 Gists、组织数据、项目看板等

简单来说，你可以直接在 AI 助手中完成大部分 GitHub 网页端的操作，极大提升开发效率。

# 在 OpenCode 中配置 GitHub MCP Server

OpenCode 支持两种方式连接 GitHub MCP Server：远程部署和本地部署。下面详细介绍远程连接方式。

# 使用远程 MCP Server（推荐）

远程 MCP Server 由 GitHub 官方托管，无需本地安装配置，非常适合大多数开发者。相比本地部署，远程方式有以下优势：

无需安装：不需要 Node.js 环境
自动认证：使用 OAuth 完成授权，无需手动管理 Token
自动更新：GitHub 官方维护，新功能自动可用
更安全：凭证存储在 GitHub 端，不泄露给本地

# 步骤一：创建 GitHub Personal Access Token

访问 GitHub Settings > Developer settings > Personal access tokens > Fine-grained tokens
点击「Generate new token」
在「Note」中填写令牌名称（如「OpenCode MCP」）
在「Permissions」中勾选必要的权限：直接全部选择
设置令牌有效期（No expiration）
点击「Generate token」生成令牌
重要：复制并妥善保存生成的 Token（页面刷新后将无法查看）

# 步骤二：创建本地密钥文件

为了安全地存储 GitHub Token，我们需要创建一个密钥文件：

在目录： ~/.config/opencode/ 下创建密钥目录： .secrets
在 ~/.config/opencode/.secrets 下新增文件 github-pat
将 GitHub Token 写入文件（直接写入 Token 文本，不要任何格式）

# 步骤三：配置 opencode.jsonc （同 opencode.json ）

在项目根目录创建或编辑 opencode.jsonc 文件，添加以下配置内容：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "github": {
      "type": "remote",
      "url": "https://api.githubcopilot.com/mcp/",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {file:~/.config/opencode/.secrets/github-pat}"
      }
    }
  }
}

注意： {file:path} 是 OpenCode 的特殊语法，用于从指定文件读取内容

配置项详细说明：

配置项	说明	必填	示例值
`mcp`	MCP 配置根节点	是	-
`github`	MCP Server 名称	是	可自定义
`type`	Server 类型	是	`remote` 或 `local`
`url`	远程 Server 端点	是（remote）	`https://api.githubcopilot.com/mcp/`
`enabled`	是否启用	否	`true` （默认）
`headers`	请求头配置	否	-
`Authorization`	认证令牌	否	Bearer Token

# 步骤四：重启 OpenCode

配置完成后，需要重启 OpenCode 使配置生效：

关闭当前 OpenCode 会话（Ctrl+C 或关闭窗口）
重新打开项目目录
OpenCode 会自动加载配置文件并连接 MCP Server

你也可以使用命令手动触发重载：

	# 重新加载配置
	opencode reload

# 步骤五：验证配置

配置生效后，可以通过以下方式验证 GitHub MCP 是否正常工作：

方法一：使用工具列表

在 OpenCode 中输入：

查看我可用的 GitHub MCP tools

如果成功，应该能看到一系列 GitHub 相关的工具，如 list_issues 、 create_pull_request 、 list_commits 等。

方法二：直接执行操作

尝试执行一个简单的 GitHub 操作：

查看我 github 所有的代码仓

如果成功返回你的仓库列表，说明配置完成！

# 总结

通过 GitHub MCP Server，OpenCode 获得了强大的 GitHub 集成能力。你可以直接在 AI 助手中完成代码审查、Issue 管理、PR 创建、Actions 监控等操作，真正实现「让 AI 帮你管理代码仓库」的高效工作体验。

无论你是个人开发者还是团队开发者，配置 GitHub MCP Server 都能显著提升工作效率。

参考文档：

OpenCode MCP Servers 官方文档
GitHub MCP Server 官方文档
MCP 规范介绍