使用 Genie Code 搜索GitHub代码

当你通过 原生 Databricks GitHub 连接器 或 自定义 GitHub MCP 服务器 连接 Genie Code 后,它就可以搜索 GitHub 存储库。 在大多数情况下,请使用原生连接器。 专用存储库访问需要GitHub组织管理员才能安装 Databricks GitHub 连接器应用。

使用本机连接器(建议)

若要将 Genie One 或 Genie Code 连接到 GitHub,请使用 Databricks 第三方连接器。 请参阅 使用 Databricks 提供的用于第三方源的 MCP 连接器,并 将 Genie One 连接到外部工具和源。 对于专用存储库,管理员需要 启用访问权限。

注册一个自定义的 GitHub MCP 服务器(不推荐)

如果你的 Azure Databricks 工作区已经有 GitHub Unity Catalog MCP 服务可供使用,请跳过这一部分。 如果你只需要访问公共仓库和自己账户的信息,请使用托管 OAuth,并跳转至 将 Unity Catalog 连接注册为 MCP 服务。

请按照以下步骤注册一个自定义的 GitHub MCP 服务器作为 MCP 服务,以满足您的具体数据和安全需求。 首先,选择 MCP 服务的身份验证方式:

  • 托管OAuth:Databricks管理GitHub OAuth应用和凭证。 跳过下面的 GitHub 应用和客户端密钥步骤,创建连接时选择托管提供程序。
  • 自定义 OAuth:创建你自己的 GitHub 应用,并在创建连接时提供其凭证。

创建一个 GitHub 应用(仅限自定义 OAuth)

  1. 创建一个GitHub应用。 对于企业代码库,GitHub组织管理员必须完成此步骤。

    • 前往个人资料>设置>开发者设置>GitHub 应用,然后点击新建 GitHub 应用。
    • 填写所需字段。 回调 URL 应为 https://<your-databricks-workspace-url>/login/oauth/http.html。 这就是GitHub使用 Databricks 工作区进行身份验证的方式。
      • 主页 URL 不会影响 MCP 服务器,并且可以设置为任何喜欢的值。
      • 清除 “活动 ”复选框,使 Webhook URL 成为可选字段。
    • 向GitHub应用授予访问存储库和组织所需的权限。
    • 单击“ 创建 GitHub 应用”。
  2. 在新建的应用的 “客户端机密”下,单击“ 生成新的客户端密码”。 复制此值。

将 Unity Catalog 连接注册为 MCP 服务

  1. 为 GitHub 创建或重用一个 Unity Catalog HTTP 连接。 你必须在架构上具有 CREATE CONNECTION 权限才能创建一个。 如果重用现有连接,你必须对其具有 USE CONNECTION。 下一步继续将该连接注册为MCP服务。 对于新连接,请使用以下认证选项之一:

    • 托管 OAuth:选择 OAuth 用户到机器(每用户) 认证类型和 GitHub OAuth 提供商。 Databricks 提供 GitHub 主机、基础路径和 OAuth 凭证。
    • 自定义OAuth:选择 OAuth 用户到机器(按用户) 认证类型和 手动配置 OAuth 提供程序。 输入以下值:
      • 主机: https://api.githubcopilot.com
      • OAuth 范围:应用的范围。 例如: mcp:access read:user user:email repo read:org
      • 客户端密钥和客户端 ID:在上述 GitHub 应用步骤中生成
      • 授权终结点: https://github.com/login/oauth/authorize
      • 令牌终结点: https://github.com/login/oauth/access_token
      • 基本路径: /mcp
    • 单击“ 创建连接”。
  2. 注册一个使用 HTTP 连接的 MCP 服务。 关于所需权限,请参见 外部MCP服务器。

    • 在你的 Azure Databricks 工作区中,转到目录/catalog,选择一个架构,然后点击创建>MCP 服务。
    • 输入目录、模式和MCP服务的名称。
    • 选择你创建或复用的 HTTP 连接,选择要暴露的工具,然后点击 “创建”。
  3. 如果你选择了按用户使用OAuth,请登录MCP服务授权你的GitHub账户。

  4. 向用户或组授予 MCP 服务上的 USE CATALOG,以及其父目录和架构上的 USE SCHEMA 和 EXECUTE。 不要向最终用户授予 USE CONNECTION。 参见 共享一个MCP。

您的 GitHub MCP 服务已准备好使用。 把它加入 Genie Code。