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.

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

Install

Run in terminal:

pip install githubchat-mcp-server

Add configuration

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

I don't have an MCP Client

Looking to get an existing one? See Awesome MCP Client

Installation

pip install githubchat-mcp-server

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.

Tools

githubchat_completion

Main tool that accepts query and GitHub URL parameters.

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())

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.1.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.1-py3-none-any.whl (5.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: githubchat_mcp_server-0.2.1.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.1.tar.gz
Algorithm Hash digest
SHA256 ec9f9c3d667bf99e353c4f331880ac9067fe814aaa4eb0407d092a907ab908fb
MD5 c33f5566174db20b6d1b6e71f38613cd
BLAKE2b-256 9dc7a3a97e78413e54403b67bb5de0fb015e59b4721903d663b0fe58f7d582fd

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for githubchat_mcp_server-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f252643349467b4e797d05565dbb055278e7c8d54a7196baa4c41f53d0e5bb21
MD5 dd0faf82323f618ebee217c608b4b349
BLAKE2b-256 e9ffa641216accd53c9037022f05d8d590ad867fcb715de35f7e2b4d7b82f967

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