home / mcp / github mcp server

GitHub MCP Server

Provides access to GitHub user repositories via HTTP and stdio MCP transports.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "kh-mahmoud-streamable-mcp": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

You can fetch GitHub repositories for any user through a dedicated MCP server that supports both HTTP access for remote clients and a local stdio workflow for MCP integrations. This dual transport design lets you query GitHub data programmatically from your applications or run the server locally during development and testing.

How to use

You can use the server with an MCP client to retrieve all public repositories for a specified GitHub username. In HTTP mode, send requests to the MCP endpoint to fetch data. In stdio mode, run the local MCP client workflow to request repository information directly from your code.

How to install

Prerequisites: Node.js v18 or higher, and npm or yarn.

1) Clone the project and navigate into the directory.

git clone https://github.com/kh-mahmoud/streamable-mcp.git
cd streamable-mcp

2) Install dependencies.

npm install

3) Build the project.

npm run build

4) Start the HTTP server for remote access.

npm run server

The server will listen on http://localhost:3000 by default (or on the port specified via the PORT environment variable).

5) Alternatively, run the local stdio mode for MCP client integration.

node build/index.js stdio

Development and inspection

For development, you can run the server with hot-reload to test changes quickly.

npm run server

You can inspect the MCP server to verify its capabilities and endpoints.

npm run inspect

Available tools

get_repos

Fetches all public repositories for a given GitHub username and returns the repository list with names.