Skip to main content
Glama

GitHub MCP Server

by timbuchinger

GitHub MCP Server

A Model Context Protocol (MCP) server implementation for interacting with GitHub issues through Cline.

Features

  • List GitHub issues from a repository
  • Create new GitHub issues
  • Error handling and validation
  • Secure authentication via environment variables

Installation

  1. Clone the repository:
git clone https://github.com/timbuchinger/mcp-github.git cd mcp-github
  1. Install dependencies with uv:
pip install uv uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv pip install -r requirements.txt
  1. Copy the environment template and configure your GitHub token:
cp .env.template .env

Edit .env and add your GitHub Personal Access Token:

GITHUB_TOKEN=your_token_here

To create a GitHub Personal Access Token:

  1. Go to GitHub Settings -> Developer settings -> Personal access tokens
  2. Generate a new token with repo scope
  3. Copy the token and paste it in your .env file

Usage

Run the MCP server:

python -m src.mcp_github.server

The server will start and expose two tools to Cline:

get_issues

Get a list of issues from a GitHub repository:

{ "repo": "owner/repo" }

create_issue

Create a new issue in a GitHub repository:

{ "repo": "owner/repo", "title": "Issue title", "body": "Issue description" }

Error Handling

The server handles common errors:

  • Missing GitHub token
  • Invalid repository name
  • Missing required parameters
  • GitHub API errors

Error responses include descriptive messages to help troubleshoot issues.

Development

The project uses uv for dependency management. To set up a development environment:

# Install all dependencies (including dev dependencies) uv pip install -r requirements.txt # Run tests pytest # Format code black . # Type checking mypy .
-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

通过模型上下文协议实现与 GitHub 问题的交互,允许用户通过安全身份验证列出和创建问题。

  1. 特征
    1. 安装
      1. 用法
        1. 获取问题
        2. 创建问题
      2. 错误处理
        1. 发展

          Related MCP Servers

          • -
            security
            F
            license
            -
            quality
            Enables management of development projects with GitHub integration, facilitating project tracking, repository linking, and metadata maintenance within the Model Context Protocol.
            Last updated -
            3
          • A
            security
            F
            license
            A
            quality
            A Model Context Protocol server that enables AI models to interact with GitHub's API, allowing for repository creation and management with descriptions, topics, and website URLs through natural language commands.
            Last updated -
            1
          • -
            security
            F
            license
            -
            quality
            Provides integration with Github through the Model Context Protocol (MCP), allowing Large Language Models to interact with Github's repositories, issues, pull requests and search functionality.
            Last updated -
            549
            2
            • Apple
          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that supports remote connections and authenticates users via GitHub OAuth, allowing them to access tools based on their GitHub identity.
            Last updated -

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/timbuchinger/mcp-github'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server