limited-github-cli-mcp

limited-github-cli-mcp

site icon
2025.04.12 0
JavaScriptGitHub 管理PR 操作开发效率
limited-github-cli-mcp 是一个基于 GitHub CLI 的 MCP 服务器,用于在 GitHub 上执行拉取请求(PR)操作。它利用本地的 `gh` 命令,无需额外的 GitHub 访问令牌,提供了一种安全的方式来管理 GitHub 仓库的 PR。
View on GitHub

Overview

基本能力

产品定位

limited-github-cli-mcp 是一个专门用于 GitHub 仓库拉取请求(PR)管理的工具,旨在简化 PR 的创建、查看、列表和评论操作。

核心功能

  1. 创建 PR (create_pr)
  2. 指定标题、正文、基础分支、头部分支和草稿选项
  3. 列出 PRs (list_prs)
  4. 根据状态(开放、关闭、合并、全部)、基础分支和结果数量进行筛选
  5. 查看 PR (view_pr)
  6. 通过 PR 编号获取详细信息
  7. 评论 PR (comment_pr)
  8. 通过 PR 编号和评论正文添加评论

适用场景

  • 开发团队需要快速创建和管理 GitHub 仓库的 PR
  • 需要自动化 PR 操作以提高开发效率
  • 需要安全地管理 GitHub 操作,避免直接使用访问令牌

工具列表

  1. create_pr: 创建新的 PR
  2. list_prs: 列出符合条件的 PRs
  3. view_pr: 查看特定 PR 的详细信息
  4. comment_pr: 在 PR 上添加评论

常见问题解答

  • 安全性: 该服务使用本地 GitHub CLI 的认证信息,无需直接处理 GitHub 访问令牌,确保操作安全。

使用教程

使用依赖

  1. 安装 GitHub CLI (gh)
  2. 使用 gh auth login 登录 GitHub 账户
  3. 本地克隆需要操作的 GitHub 仓库

安装教程

无需额外安装步骤,只需确保 GitHub CLI 已安装并配置。

调试方式

使用以下命令示例进行调试:

创建 PR

use_mcp_tool({
  server_name: "limited-github-cli",
  tool_name: "create_pr",
  arguments: {
    title: "Add new feature",
    body: "This PR adds feature X",
    base: "main",
    head: "feature/x",
    draft: true
  }
})

列出 PRs

use_mcp_tool({
  server_name: "limited-github-cli",
  tool_name: "list_prs",
  arguments: {
    state: "open",
    limit: 5
  }
})

查看 PR 详情

use_mcp_tool({
  server_name: "limited-github-cli",
  tool_name: "view_pr",
  arguments: {
    number: 123
  }
})

评论 PR

use_mcp_tool({
  server_name: "limited-github-cli",
  tool_name: "comment_pr",
  arguments: {
    number: 123,
    body: "I've reviewed this. LGTM!"
  }
})

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。