github-mcp-server
Provides tools for searching GitHub repositories, listing issues, and reading file contents from GitHub repositories.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@github-mcp-server Search for TypeScript MCP server repositories with more than 100 stars."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 GitHub repos by keyword — returns name, description, URL, stars, forks, language |
| List issues for any public (or accessible private) repo — filter by state and labels |
| Read the raw text of any file in a repo — specify an optional branch/tag/commit ref |
Related MCP server: mcp-github-server
Requirements
Node.js ≥ 20
A GitHub Personal Access Token (PAT) with at least the
public_repo(orrepofor private repos) scope
Installation
git clone https://github.com/kevinshim/github-mcp-server.git
cd github-mcp-server
npm install
npm run buildUsage
Start the server manually (for testing):
GITHUB_TOKEN=ghp_your_token node build/index.jsRegister 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.mdLicense
MIT
Available Tools
3 toolslist_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
Scored across 3 tools
Each tool targets a clearly different resource and action: searching repositories, listing issues, and reading file contents. There is no meaningful overlap between them.
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.
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.
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
Related MCP Connectors
An MCP server that gives your AI access to the source code and docs of all public github repos
Create, deploy, and operate MCP servers directly from your GitHub repositories.
A MCP server built for developers enabling Git based project management with project and personal…
Repository knowledge graph MCP server for codebase understanding and debugging.
Related MCP Servers
- -licenseNot gradedqualityBmaintenanceMCP Server for the GitHub API, enabling file operations, repository management, search functionality, and more.127,455 npm92,139MIT
- FlicenseNot gradedqualityDmaintenanceA simple MCP server that provides repository information (list repos, get repo details) using GitHub's public REST API, without needing any API keys or tokens.-
- AlicenseBqualityDmaintenanceMCP (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.158 npmMIT
- FlicenseNot gradedqualityDmaintenanceMCP server for GitHub operations, providing tools for repository management, issues, pull requests, and code search.-