MCP.so
登录

mcp-github-cli

@michaelneale

关于 mcp-github-cli

a MCP server for github using the GH cli under the covers

基本信息

分类

开发工具

运行时

python

传输方式

stdio

发布者

michaelneale

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-github-cli": {
      "command": "uvx",
      "args": [
        "mcp-github-cli"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is mcp-github-cli?

mcp-github-cli is an MCP server that provides focused GraphQL and REST API tools for interacting with GitHub. It leverages GitHub’s APIs to offer a streamlined set of powerful tools for retrieving rich data and performing common operations.

How to use mcp-github-cli?

Run with uvx mcp-github-cli from the command line. Prerequisites are installing the GitHub CLI (gh) and authenticating via gh auth login. Can be used with Goose or Claude. For a test run, execute uv run python main.py --test from the source directory.

Key features of mcp-github-cli

  • Get detailed authenticated user information via gh_get_me
  • Execute GraphQL queries for repos, users, PRs, and issues
  • Run custom GraphQL queries with gh_custom_graphql
  • Search repositories using the REST API
  • Create issues and pull requests via REST endpoints
  • List branches, commits, and repository contents

Use cases of mcp-github-cli

  • Retrieve the authenticated user’s GitHub profile
  • Get comprehensive repository information with a single GraphQL request
  • Search for repositories by language, stars, or other criteria
  • Create issues and pull requests programmatically from an MCP client
  • List branches and commits for a given repository

FAQ from mcp-github-cli

What are the prerequisites?

Install the GitHub CLI (gh) via a package manager (e.g., brew install gh on macOS) and authenticate with gh auth login.

Can I use this server with Claude or Goose?

Yes, it can be used in Goose or Claude as an MCP server. Run it with uvx mcp-github-cli.

How do I test the server functionality?

Run uv run python main.py --test from the source directory. This verifies authentication, user info retrieval, GraphQL queries, REST searches, and other tools.

How do I publish an updated version?

Update the version in pyproject.toml, clean previous builds (rm -rf dist/*), build the package with python -m build, and upload to PyPI using twine.

What tools are available for custom queries?

You can execute custom GraphQL queries with gh_custom_graphql(query, variables) and custom REST API requests with gh_rest_api(endpoint, method, data, query_params).

评论

开发工具 分类下的更多 MCP 服务器