Skip to main content
Glama
github-mcp-server

github-mcp-server

by ibmkevin

github-mcp-server

A lightweight Model Context Protocol (MCP) server that exposes three GitHub utility tools to AI agents (such as IBM Bob).

Tools

Tool

Description

search_repositories

Search GitHub repos by keyword — returns name, description, URL, stars, forks, language

list_issues

List issues for any public (or accessible private) repo — filter by state and labels

read_file_contents

Read the raw text of any file in a repo — specify an optional branch/tag/commit ref

Related MCP server: mcp-github-server

Requirements

Installation

git clone https://github.com/kevinshim/github-mcp-server.git
cd github-mcp-server
npm install
npm run build

Usage

Start the server manually (for testing):

GITHUB_TOKEN=ghp_your_token node build/index.js

Register with IBM Bob

Add the following to your Bob mcp.json (global: ~/.bob/mcp.json, or workspace: .bob/mcp.json):

{
  "mcpServers": {
    "github-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/github-mcp-server/build/index.js"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Replace /absolute/path/to/github-mcp-server with the actual path on your machine.

Example prompts (inside Bob)

Search for TypeScript MCP server repositories with more than 100 stars.

List the open bug issues in IBM/galaxium-travels.

Read the contents of src/index.ts from my-org/my-repo on branch main.

Project structure

github-mcp-server/
├── src/
│   └── index.ts        # Server implementation
├── build/              # Compiled output (generated by npm run build)
├── package.json
├── tsconfig.json
└── README.md

License

MIT

Available Tools

3 tools
list_issuesA

List issues for a GitHub repository. Returns issue number, title, state, labels, author, and URL.

Inputs: repo (required), owner (required), state, labels, +1 more.

read_file_contentsA

Read the raw text contents of a file from a GitHub repository. Returns the decoded file content.

Inputs: path (required), repo (required), owner (required), ref.

search_repositoriesB

Search GitHub repositories by keyword. Returns repo name, description, URL, stars, forks, and primary language.

Inputs: query (required), sort, per_page.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool targets a clearly different resource and action: searching repositories, listing issues, and reading file contents. There is no meaningful overlap between them.

    Naming Consistency5/5

    All tool names follow the same lowercase snake_case verb_noun pattern: search_repositories, list_issues, read_file_contents. The convention is consistent and predictable.

    Tool Count3/5

    Three tools is on the low end for a server named github-mcp-server. While the set is focused and each tool earns its place, the name implies a broader GitHub surface than three read-only operations.

    Completeness2/5

    The server lacks many core GitHub operations such as getting a single repository, creating or updating issues, listing pull requests, or exploring file paths before reading them. Agents would frequently hit dead ends, especially after searching for a repo or listing issues.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      MCP (Model Context Protocol) server for GitHub API integration. This server provides comprehensive tools for interacting with GitHub repositories, issues, pull requests, branches, and code search through a unified interface.
      15
      8 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server for GitHub operations, providing tools for repository management, issues, pull requests, and code search.
      -