Github Chat MCP

🚀 GitHub Chat MCP Server

The GitHub Chat MCP Server provides a way to interact with GitHub repositories using specific APIs and tools.

🚀 Quick Start

📦 Installation

⚠️ Important Note

First, make sure you have a GitHub Chat API key. This is required to use the service.

First, install uv.

MacOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

💻 Usage Examples

Basic Usage

Setup with Cursor (Recommended)

In mcp.json:

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

After this configuration, no additional environment variables are required as this is a free version.

Advanced Usage

Setup with Claude Desktop

# claude_desktop_config.json
# You can find the location by:
# Clicking the hamburger menu -> File -> Settings -> Developer -> Edit Configuration
# You must first run: brew install uv
{
  "mcpServers": {
    "github-chat": {
      "command": "uvx",
      "args": ["github-chat-mcp"],
      "env": {
      }
    }
  }
}

Installation via Smithery

You can automatically install GitHub Chat for Claude Desktop:

npx -y @smithery/cli install github-chat-mcp --client claude

Using GitHub Chat with Claude

1. First, index a GitHub repository: "Analyze the React repository"

2. Then, ask questions about the repository: "What is the core technology stack of this repository?"

Debugging

Run:

npx @modelcontextprotocol/inspector uvx github-chat-mcp

🔧 Technical Details

Local Development Environment Configuration

Clone the Repository

git clone https://github.com/yourusername/github-chat-mcp.git

Install Dependencies

First, install uv.

MacOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Then, install the dependencies for the MCP server:

cd github-chat-mcp

# Create and activate a virtual environment
uv venv

source .venv/bin/activate # MacOS/Linux
# Or
.venv/Scripts/activate # Windows

# Install dependencies
uv sync

Configuration with Claude Desktop

Using the MCP CLI SDK

# If you haven't installed it yet, run `pip install mcp[cli]` first
mcp install /ABSOLUTE/PATH/TO/PARENT/FOLDER/github-chat-mcp/src/github_chat_mcp/server.py -v "GITHUB_API_KEY=API_KEY_HERE"

Manual Configuration

# claude_desktop_config.json
# You can find the location by:
# Clicking the hamburger menu -> File -> Settings -> Developer -> Edit Configuration
{
  "mcpServers": {
    "github-chat": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/github-chat-mcp",
        "run",
        "github-chat-mcp"
      ],
      "env": {
      }
    }
  }
}

Using GitHub Chat with Claude

1. First, index a GitHub repository: "Analyze the React repository"

2. Then, ask questions about the repository: "What is the core technology stack of this repository?"

Debugging

Run:

# If you have installed the MCP CLI (`pip install mcp[cli]`)
mcp dev /ABSOLUTE/PATH/TO/PARENT/FOLDER/github-chat-mcp/src/github_chat_mcp/server.py

# If not installed
npx @modelcontextprotocol