在 goose 中接入 GitHub MCP Server以 Remote ExtensionStreamable HTTP开启仓库管理与自动化 PR【免费下载链接】goosean open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM项目地址: https://gitcode.com/GitHub_Trending/goose3/gooseGoose本仓库是支持任意 LLM 的开放式可扩展 AI Agent其扩展体系基于 MCPModel Context Protocol。本文围绕官方文档 github-mcp.md完整演示如何把 GitHub MCP Server 以「Remote Extension (Streamable HTTP)」的形式注册进 goose让 goose 具备创建分支、改文件、提交、开 Pull Request 等仓库级操作能力。读完本文你将掌握在 goose Desktop 与 goose CLI 两套界面下配置远程 MCP 扩展的完整流程、底层配置文件的字段含义以及一套可直接照抄的真实自动化场景。功能概览为什么要在 goose 里接入 GitHub MCP ServerGitHub MCP Server 是一个把 GitHub 平台能力封装成 MCP 工具的服务端。把它添加为 goose Extension 后goose 可以代表你执行文件操作创建、更新仓库文件如create_or_update_file仓库管理创建分支如create_branch、维护仓库元数据搜索功能检索代码、Issue、PR 等协作功能打开 Pull Request如create_pull_request。也就是说日常需要打开网页、切到 git 客户端手工完成的重复性操作可以直接用一句自然语言交给 goose 完成。说明本文聚焦「远程Remote」部署方式即直连 GitHub 官方托管的 MCP 端点。GitHub MCP Server 还有其他部署形态本地自托管等如需要可参考 GitHub MCP Server 官方文档进一步了解本文不展开。前置准备创建带最小权限的 GitHub Personal Access Token远程接入 GitHub MCP Server 的鉴权方式是 HTTP Header 中的Authorization: Bearer TOKEN因此第一步是准备一个 GitHub Personal Access TokenPAT。官方文档给出的示例 Token 授权策略是「fine-grained」最小化授权值得直接照搬仓库范围仅授权目标仓库示例为angiejones/goose-demo这类单仓库metadata授予 Read 权限GitHub 元数据权限是所有细粒度 Token 的必需项code、commit status、issues、pull requests授予 Read and Write 权限。按最小权限原则只给 goose 完成目标任务所需的仓库能有效把风险限制在可控范围内。该 Token 只应写入 goose 的扩展配置或密钥存储不要泄露到公开代码中。快速安装一行式接入与最简配置官方文档提供了一组 Quick Install 参数两套界面共用同一组值配置项值扩展类型Remote Extension (Streamable HTTP)Endpoint URLhttps://api.githubcopilot.com/mcp/Custom Request HeaderAuthorization: Bearer YOUR_GITHUB_PERSONAL_ACCESS_TOKENgoose Desktop 快速安装goose Desktop 支持通过goose://extension协议一键拉起安装器。该 Deep Link 会把下述参数预填进扩展安装向导goose://extension?typestreamable_httpurlhttps%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fidgithub-mcpnameGitHubdescriptionGitHub%20repository%20management%20and%20operationsheaderAuthorization%3DBearer%20YOUR_GITHUB_PERSONAL_ACCESS_TOKENgoose CLI 快速安装在goose configure中选择添加Remote Extension (Streamable HTTP)填入上表的 Endpoint URL并在随后添加自定义请求头Authorization: Bearer YOUR_GITHUB_PERSONAL_ACCESS_TOKEN逐步配置goose Desktop 与 goose CLI 两套完整流程在 goose Desktop 中添加扩展Desktop 端可视化引导的核心字段如下配置向导 UI 由 GooseDesktopInstaller.tsx 渲染extensionIdgithub-mcp扩展唯一标识Extension NameGitHubDescriptionGitHub repository management and operationstypehttp即 Streamable HTTP 远程扩展urlhttps://api.githubcopilot.com/mcp/Authorization 请求头Bearer YOUR_GITHUB_PERSONAL_ACCESS_TOKEN在向导中填好 Endpoint URL 后会继续询问是否添加自定义请求头选择 Yes 并逐项录入 Header 名称与值即可。在 goose CLI 中通过交互向导配置CLI 端由goose configure驱动交互界面由 CLIExtensionInstructions.tsx 的模板生成共 7 步┌ goose-configure │ ◇ What would you like to configure? │ Add Extension │ ◇ What type of extension would you like to add? │ ● Remote Extension (Streamable HTTP) (Connect to a remote extension via MCP Streamable HTTP) │ ◇ What would you like to call this extension? │ github │ ◇ What is the Streamable HTTP endpoint URI? │ https://api.githubcopilot.com/mcp/ │ ◇ Please set the timeout for this tool (in secs): │ 300 │ ◇ Enter a description for this extension: │ GitHub repository management and operations │ ◇ Would you like to add custom headers? │ Yes │ ◇ Header name: │ Authorization │ ◇ Header value: │ Bearer ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx │ ◇ Add another header? │ No │ └ Added github extension其中几个环节的默认行为值得留意超时时间默认300秒对应源码常量DEFAULT_EXTENSION_TIMEOUT见 crates/goose/src/config/extensions.rs。远程仓库操作如创建 PR耗时较长建议按官方默认 300s 保留充足余量。自定义请求头必须选择 Yes 并录入Authorization: Bearer TOKEN否则 GitHub MCP Server 会因缺少鉴权拒绝请求。Token 处理官方建议在 [GitHub Settings] 的 Personal access tokens 页面获取 Token并作为Bearer值粘贴。配置落盘理解 config.yaml 中的扩展定义上述交互式配置最终会被写入 goose 的主配置文件。文件默认位置为macOS / Linux~/.config/goose/config.yamlWindows%APPDATA%\Block\goose\config\config.yaml扩展统一挂在extensions键下完整字段说明见 配置文件指南。GitHub MCP Server 注册后会形成类似下面的 YAML 片段extensions: github: type: streamable_http name: github description: GitHub repository management and operations enabled: true uri: https://api.githubcopilot.com/mcp/ headers: Authorization: Bearer ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx timeout: 300# 不推荐将令牌写入环境变量只能以 envs 传递远程 HTTP 扩展的鉴权头应放 headers # extensions: # github: # type: streamable_http # uri: https://api.githubcopilot.com/mcp/ # envs: # GITHUB_TOKEN: ghp_xxx源码视角streamable_http 扩展类型支持哪些字段了解 goose 底层如何解析这类远程扩展有助于排查问题与手工编辑配置。扩展模型定义在 crates/goose/src/agents/extension.rs其中ExtensionConfig枚举支持stdio、builtin、platform、streamable_http四种形态StreamableHttp变体serde 名称为streamable_http对应的字段包括字段含义说明name扩展名用于标识示例为githuburi远程端点MCP Streamable HTTP 端点地址headers自定义请求头用于承载Authorization: Bearer ...timeout超时秒数类型为Optionu64新配置建议显式给出默认 300senvs/env_keys环境变量本地启动类扩展用远程 HTTP 场景一般不涉及socketUnix domain socket 路径HTTP-over-UDS 传输可选name表示 Linux abstract socketclient_id/client_secret_key/scopesOAuth 参数支持预注册 OAuth client 的授权服务器适用于不支持动态注册的鉴权场景配置读写逻辑集中在 crates/goose/src/config/extensions.rs值得注意的实现细节键名归一化name_to_key会把扩展名转为小写并丢弃空白如GitHub MCP归一到githubmcp并作为配置文件中的 key 使用。SSE 已废弃get_warnings对配置里type: sse的旧条目会输出提示——SSE 不再受支持需要迁移到streamable_http对应文档 config-files.md 中“SSE is not supported; migrate tostreamable_http”的描述。工具白名单available_tools字段可限定只加载需要的工具列表为空表示加载全部在只需要部分 GitHub 能力时可减少会话 Token 开销。实战演练一句提示词完成「建分支 → 改文件 → 开 PR」官方文档给出一段端到端示例。当 goose 完成配置后向它发出如下提示词create a new branch called hello-world in my angiejones/goose-demo repository. Update the README.md file to say this was written by goose and commit it. Open a pull request with your changes.goose 会按以下工具调用链推进Ill help you create a new branch, update the README, and open a pull request. Let me break this down into steps: 1. First, lets create the new branch called hello-world in your repository 2. Then update the README.md file 3. Finally, create a pull request Let me execute these steps: 1. Creating the new branch: ─── create_branch | github ────────────────────────── branch: hello-world owner: angiejones repo: goose-demo 2. Now, updating the README.md file in the new branch: ─── create_or_update_file | github ────────────────────────── branch: hello-world content: this was written by goose message: Update README.md with goose message owner: angiejones path: README.md repo: goose-demo 3. Finally, creating the pull request: ─── create_pull_request | github ────────────────────────── base: main body: ... head: hello-world owner: angiejones repo: goose-demo title: Update README.md执行完成后 goose 会汇总结果Great! Ive completed all the requested tasks: 1. Created a new branch called hello-world 2. Updated the README.md file with the text this was written by goose 3. Created a pull request to merge these changes into the main branch随后 goose 会给出对应的 Pull Request 地址供你 review。整个过程中工具调用面板里的github前缀表明每次工具调用都来自刚注册的 GitHub 扩展——这正是「Remote Extension (Streamable HTTP)」生效的直接证据。使用与安全建议Token 尽量用细粒度fine-grained并限仓库只给目标仓库授权metadata 为只读code / commit status / issues / pull requests 按需给读写避免使用仓库全量权限的 Token。Header 即鉴权不要漏配远端端点要求请求头Authorization: Bearer TOKEN若在 CLI 向导里跳过添加自定义请求头工具调用会因鉴权失败。通过goose configure管理而非直接改配置手工编辑config.yaml需保证缩进与字段名准确例如type必须是streamable_http、headers是 map建议改动后用goose重新加载验证。升级旧配置如果你的历史配置里还写着type: ssegoose 会在加载时给出告警请迁移为streamable_http。延伸阅读本文所依据的原始文档documentation/docs/mcp/github-mcp.mdgoose 配置文件与扩展 YAML 全字段说明configuration files 指南扩展类型的源码定义含streamable_http全部字段crates/goose/src/agents/extension.rs扩展读写与 SSE 迁移告警逻辑crates/goose/src/config/extensions.rs扩展安装交互组件的实现CLI/Desktop 向导文本来源documentation/src/components/CLIExtensionInstructions.tsx、documentation/src/components/GooseDesktopInstaller.tsxgoose CLI 更多命令goose-cli-commands 指南【免费下载链接】goosean open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM项目地址: https://gitcode.com/GitHub_Trending/goose3/goose创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 在 goose 中接入 GitHub MCP Server：以 Remote Extension（Streamable HTTP）开启仓库管理与自动化 PR
在 goose 中接入 GitHub MCP Server以 Remote ExtensionStreamable HTTP开启仓库管理与自动化 PR【免费下载链接】goosean open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM项目地址: https://gitcode.com/GitHub_Trending/goose3/gooseGoose本仓库是支持任意 LLM 的开放式可扩展 AI Agent其扩展体系基于 MCPModel Context Protocol。本文围绕官方文档 github-mcp.md完整演示如何把 GitHub MCP Server 以「Remote Extension (Streamable HTTP)」的形式注册进 goose让 goose 具备创建分支、改文件、提交、开 Pull Request 等仓库级操作能力。读完本文你将掌握在 goose Desktop 与 goose CLI 两套界面下配置远程 MCP 扩展的完整流程、底层配置文件的字段含义以及一套可直接照抄的真实自动化场景。功能概览为什么要在 goose 里接入 GitHub MCP ServerGitHub MCP Server 是一个把 GitHub 平台能力封装成 MCP 工具的服务端。把它添加为 goose Extension 后goose 可以代表你执行文件操作创建、更新仓库文件如create_or_update_file仓库管理创建分支如create_branch、维护仓库元数据搜索功能检索代码、Issue、PR 等协作功能打开 Pull Request如create_pull_request。也就是说日常需要打开网页、切到 git 客户端手工完成的重复性操作可以直接用一句自然语言交给 goose 完成。说明本文聚焦「远程Remote」部署方式即直连 GitHub 官方托管的 MCP 端点。GitHub MCP Server 还有其他部署形态本地自托管等如需要可参考 GitHub MCP Server 官方文档进一步了解本文不展开。前置准备创建带最小权限的 GitHub Personal Access Token远程接入 GitHub MCP Server 的鉴权方式是 HTTP Header 中的Authorization: Bearer TOKEN因此第一步是准备一个 GitHub Personal Access TokenPAT。官方文档给出的示例 Token 授权策略是「fine-grained」最小化授权值得直接照搬仓库范围仅授权目标仓库示例为angiejones/goose-demo这类单仓库metadata授予 Read 权限GitHub 元数据权限是所有细粒度 Token 的必需项code、commit status、issues、pull requests授予 Read and Write 权限。按最小权限原则只给 goose 完成目标任务所需的仓库能有效把风险限制在可控范围内。该 Token 只应写入 goose 的扩展配置或密钥存储不要泄露到公开代码中。快速安装一行式接入与最简配置官方文档提供了一组 Quick Install 参数两套界面共用同一组值配置项值扩展类型Remote Extension (Streamable HTTP)Endpoint URLhttps://api.githubcopilot.com/mcp/Custom Request HeaderAuthorization: Bearer YOUR_GITHUB_PERSONAL_ACCESS_TOKENgoose Desktop 快速安装goose Desktop 支持通过goose://extension协议一键拉起安装器。该 Deep Link 会把下述参数预填进扩展安装向导goose://extension?typestreamable_httpurlhttps%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fidgithub-mcpnameGitHubdescriptionGitHub%20repository%20management%20and%20operationsheaderAuthorization%3DBearer%20YOUR_GITHUB_PERSONAL_ACCESS_TOKENgoose CLI 快速安装在goose configure中选择添加Remote Extension (Streamable HTTP)填入上表的 Endpoint URL并在随后添加自定义请求头Authorization: Bearer YOUR_GITHUB_PERSONAL_ACCESS_TOKEN逐步配置goose Desktop 与 goose CLI 两套完整流程在 goose Desktop 中添加扩展Desktop 端可视化引导的核心字段如下配置向导 UI 由 GooseDesktopInstaller.tsx 渲染extensionIdgithub-mcp扩展唯一标识Extension NameGitHubDescriptionGitHub repository management and operationstypehttp即 Streamable HTTP 远程扩展urlhttps://api.githubcopilot.com/mcp/Authorization 请求头Bearer YOUR_GITHUB_PERSONAL_ACCESS_TOKEN在向导中填好 Endpoint URL 后会继续询问是否添加自定义请求头选择 Yes 并逐项录入 Header 名称与值即可。在 goose CLI 中通过交互向导配置CLI 端由goose configure驱动交互界面由 CLIExtensionInstructions.tsx 的模板生成共 7 步┌ goose-configure │ ◇ What would you like to configure? │ Add Extension │ ◇ What type of extension would you like to add? │ ● Remote Extension (Streamable HTTP) (Connect to a remote extension via MCP Streamable HTTP) │ ◇ What would you like to call this extension? │ github │ ◇ What is the Streamable HTTP endpoint URI? │ https://api.githubcopilot.com/mcp/ │ ◇ Please set the timeout for this tool (in secs): │ 300 │ ◇ Enter a description for this extension: │ GitHub repository management and operations │ ◇ Would you like to add custom headers? │ Yes │ ◇ Header name: │ Authorization │ ◇ Header value: │ Bearer ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx │ ◇ Add another header? │ No │ └ Added github extension其中几个环节的默认行为值得留意超时时间默认300秒对应源码常量DEFAULT_EXTENSION_TIMEOUT见 crates/goose/src/config/extensions.rs。远程仓库操作如创建 PR耗时较长建议按官方默认 300s 保留充足余量。自定义请求头必须选择 Yes 并录入Authorization: Bearer TOKEN否则 GitHub MCP Server 会因缺少鉴权拒绝请求。Token 处理官方建议在 [GitHub Settings] 的 Personal access tokens 页面获取 Token并作为Bearer值粘贴。配置落盘理解 config.yaml 中的扩展定义上述交互式配置最终会被写入 goose 的主配置文件。文件默认位置为macOS / Linux~/.config/goose/config.yamlWindows%APPDATA%\Block\goose\config\config.yaml扩展统一挂在extensions键下完整字段说明见 配置文件指南。GitHub MCP Server 注册后会形成类似下面的 YAML 片段extensions: github: type: streamable_http name: github description: GitHub repository management and operations enabled: true uri: https://api.githubcopilot.com/mcp/ headers: Authorization: Bearer ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx timeout: 300# 不推荐将令牌写入环境变量只能以 envs 传递远程 HTTP 扩展的鉴权头应放 headers # extensions: # github: # type: streamable_http # uri: https://api.githubcopilot.com/mcp/ # envs: # GITHUB_TOKEN: ghp_xxx源码视角streamable_http 扩展类型支持哪些字段了解 goose 底层如何解析这类远程扩展有助于排查问题与手工编辑配置。扩展模型定义在 crates/goose/src/agents/extension.rs其中ExtensionConfig枚举支持stdio、builtin、platform、streamable_http四种形态StreamableHttp变体serde 名称为streamable_http对应的字段包括字段含义说明name扩展名用于标识示例为githuburi远程端点MCP Streamable HTTP 端点地址headers自定义请求头用于承载Authorization: Bearer ...timeout超时秒数类型为Optionu64新配置建议显式给出默认 300senvs/env_keys环境变量本地启动类扩展用远程 HTTP 场景一般不涉及socketUnix domain socket 路径HTTP-over-UDS 传输可选name表示 Linux abstract socketclient_id/client_secret_key/scopesOAuth 参数支持预注册 OAuth client 的授权服务器适用于不支持动态注册的鉴权场景配置读写逻辑集中在 crates/goose/src/config/extensions.rs值得注意的实现细节键名归一化name_to_key会把扩展名转为小写并丢弃空白如GitHub MCP归一到githubmcp并作为配置文件中的 key 使用。SSE 已废弃get_warnings对配置里type: sse的旧条目会输出提示——SSE 不再受支持需要迁移到streamable_http对应文档 config-files.md 中“SSE is not supported; migrate tostreamable_http”的描述。工具白名单available_tools字段可限定只加载需要的工具列表为空表示加载全部在只需要部分 GitHub 能力时可减少会话 Token 开销。实战演练一句提示词完成「建分支 → 改文件 → 开 PR」官方文档给出一段端到端示例。当 goose 完成配置后向它发出如下提示词create a new branch called hello-world in my angiejones/goose-demo repository. Update the README.md file to say this was written by goose and commit it. Open a pull request with your changes.goose 会按以下工具调用链推进Ill help you create a new branch, update the README, and open a pull request. Let me break this down into steps: 1. First, lets create the new branch called hello-world in your repository 2. Then update the README.md file 3. Finally, create a pull request Let me execute these steps: 1. Creating the new branch: ─── create_branch | github ────────────────────────── branch: hello-world owner: angiejones repo: goose-demo 2. Now, updating the README.md file in the new branch: ─── create_or_update_file | github ────────────────────────── branch: hello-world content: this was written by goose message: Update README.md with goose message owner: angiejones path: README.md repo: goose-demo 3. Finally, creating the pull request: ─── create_pull_request | github ────────────────────────── base: main body: ... head: hello-world owner: angiejones repo: goose-demo title: Update README.md执行完成后 goose 会汇总结果Great! Ive completed all the requested tasks: 1. Created a new branch called hello-world 2. Updated the README.md file with the text this was written by goose 3. Created a pull request to merge these changes into the main branch随后 goose 会给出对应的 Pull Request 地址供你 review。整个过程中工具调用面板里的github前缀表明每次工具调用都来自刚注册的 GitHub 扩展——这正是「Remote Extension (Streamable HTTP)」生效的直接证据。使用与安全建议Token 尽量用细粒度fine-grained并限仓库只给目标仓库授权metadata 为只读code / commit status / issues / pull requests 按需给读写避免使用仓库全量权限的 Token。Header 即鉴权不要漏配远端端点要求请求头Authorization: Bearer TOKEN若在 CLI 向导里跳过添加自定义请求头工具调用会因鉴权失败。通过goose configure管理而非直接改配置手工编辑config.yaml需保证缩进与字段名准确例如type必须是streamable_http、headers是 map建议改动后用goose重新加载验证。升级旧配置如果你的历史配置里还写着type: ssegoose 会在加载时给出告警请迁移为streamable_http。延伸阅读本文所依据的原始文档documentation/docs/mcp/github-mcp.mdgoose 配置文件与扩展 YAML 全字段说明configuration files 指南扩展类型的源码定义含streamable_http全部字段crates/goose/src/agents/extension.rs扩展读写与 SSE 迁移告警逻辑crates/goose/src/config/extensions.rs扩展安装交互组件的实现CLI/Desktop 向导文本来源documentation/src/components/CLIExtensionInstructions.tsx、documentation/src/components/GooseDesktopInstaller.tsxgoose CLI 更多命令goose-cli-commands 指南【免费下载链接】goosean open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM项目地址: https://gitcode.com/GitHub_Trending/goose3/goose创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考