Skip to main content

Model Context Protocol (MCP) server for GitHub Chat

Project description

GitHubChat MCP Server

Model Context Protocol (MCP) server for GitHub Chat.

Get Started

I have an MCP Client (eg. Cursor, Claude, Cline)

Run in terminal:

pip install githubchat-mcp-server && githubchat-mcp-server

Add githubchat server to your client's MCP configuration, commonly:

{
    "mcpServers": {
        "githubchat": {
            "url": "http://localhost:4651/githubchat-mcp"
        }
    }
}

Refer to your MCP client's documentation for supported configuration specifications.

I don't have an MCP Client

Looking to get an existing one? See Awesome MCP Client

Example request using FastMCP client:

import asyncio
from fastmcp import Client
import json

async def main():
    # Connect to the MCP server
    async with Client("http://localhost:4651/githubchat-mcp") as client:
        # Request completion
        print("\nRequesting completion...\n\n")
        result = await client.call_tool("githubchat_completion", {
            "query": "your query",
            "url": "https://github.com/username/repo"
        })
        print(json.dumps(json.loads(result[0].text), indent=2))

if __name__ == "__main__":
    asyncio.run(main())

Documentation

Install

pip install githubchat-mcp-server

Run

After installation, you can run the server in two ways:

  1. Using the command-line script:
# Default port (4651)
githubchat-mcp-server

# Custom port
githubchat-mcp-server --port 3000
  1. Using Python directly:
# Default port (4651)
python -m githubchat_mcp_server

# Custom port
python -m githubchat_mcp_server --port 3000

The server will run on localhost using streamable-http transport.

Available Tools

githubchat_completion

Main tool that accepts query and GitHub URL parameters.

Supported GitHub URL formats:

  • Repository URLs (e.g., https://github.com/username/repo)
  • File URLs (e.g., https://github.com/username/repo/blob/main/file.md)
  • Branch URLs (e.g., https://github.com/username/repo/tree/feat/branch)
  • Wiki URLs (e.g., https://github.com/username/repo/wiki)

License

All rights reserved, Bluera Inc..

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

githubchat_mcp_server-0.2.2.tar.gz (5.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

githubchat_mcp_server-0.2.2-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

Details for the file githubchat_mcp_server-0.2.2.tar.gz.

File metadata

  • Download URL: githubchat_mcp_server-0.2.2.tar.gz
  • Upload date:
  • Size: 5.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.6

File hashes

Hashes for githubchat_mcp_server-0.2.2.tar.gz
Algorithm Hash digest
SHA256 9ce5589e2732dc37bb0c20f220ecc7bed0206f635526991e5f251e1a393c355e
MD5 708ab7967d4090659e59a8b0f071ec6b
BLAKE2b-256 eacbddacfe80ddf45c0b1fbda3f7babc0d229f91e8a5d49f2767c0606a2049ae

See more details on using hashes here.

File details

Details for the file githubchat_mcp_server-0.2.2-py3-none-any.whl.

File metadata

File hashes

Hashes for githubchat_mcp_server-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 cedad28cd8d9c61276a309a7d17681c9c2c1ed9b179ba770629bdfe132718e61
MD5 01cfe8665fd5760942151b22dc8973fd
BLAKE2b-256 ce8c1bc388f553e2b1c8b927e920a5b0236d587628bb1b60785b5f3a881c37e5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page