Skip to content

fix: correct README numbers, add tool index, bump to 0.3.0 #87

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ldraney merged 1 commit into from
Feb 1, 2026
Merged

fix: correct README numbers, add tool index, bump to 0.3.0 #87

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Project Overview

This is a GitHub MCP (Model Context Protocol) server that wraps Octokit to provide 800+ GitHub API endpoints as MCP tools, with OAuth Device Flow authentication and real-time webhook event handling.
This is a GitHub MCP (Model Context Protocol) server that wraps Octokit to provide 327 GitHub API endpoints as MCP tools, with OAuth Device Flow authentication and real-time webhook event handling.

## Quick Start

Expand Down
18 changes: 9 additions & 9 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# github-mcp

A comprehensive GitHub MCP server with OAuth Device Flow authentication and 800+ endpoint coverage.
A comprehensive GitHub MCP server with OAuth Device Flow authentication and 327 endpoint coverage.

## Features

- **800+ GitHub API endpoints** as MCP tools (vs ~50 in official server)
- **327 GitHub API endpoints** as MCP tools (vs ~50 in official server)
- **OAuth Device Flow** - No PAT management, just authenticate in browser
- **OS Keychain storage** - Secure token storage via keytar
- **Real-time webhooks** - GitHub events as MCP resources via smee.io
Expand Down Expand Up @@ -84,10 +84,10 @@ GITHUB_TOKEN=ghp_xxx github-mcp
Claude Desktop has a ~100 tool limit. Use presets to load only what you need:

```bash
github-mcp --preset core # Daily dev work (~95 tools)
github-mcp --preset security # Security audits (~50 tools)
github-mcp --preset org-admin # Org management (~70 tools)
github-mcp --preset cicd # CI/CD automation (~60 tools)
github-mcp --preset core # Daily dev work (~109 tools)
github-mcp --preset security # Security audits (~38 tools)
github-mcp --preset org-admin # Org management (~92 tools)
github-mcp --preset cicd # CI/CD automation (~71 tools)
github-mcp --preset full # All 327 tools (Claude Code only)
```

Expand All @@ -97,7 +97,7 @@ github-mcp --preset full # All 327 tools (Claude Code only)
| `security` | dependabot, secretScanning, codeScanning, codeSecurity, securityAdvisories | Security audits |
| `org-admin` | orgs, teams, projects, activity, users, apps | Organization management |
| `cicd` | actions, checks, repos, packages | CI/CD pipelines |
| `full` | all 32 categories | Claude Code with tool search |
| `full` | all 33 categories | Claude Code with tool search |

List presets: `github-mcp --list-presets`

Expand All @@ -115,7 +115,7 @@ Tools are organized by GitHub API category:
| `github_users_*` | get, list, followers |
| `github_actions_*` | workflows, runs, jobs |
| `github_gists_*` | list, get, create |
| ... | 38 categories total |
| ... | 33 categories total |

## Webhook Events

Expand Down Expand Up @@ -147,7 +147,7 @@ Environment variables:

| Feature | Official (Go) | github-mcp |
|---------|---------------|------------|
| Endpoints | ~50 | 800+ |
| Endpoints | ~50 | 327 |
| Auth | PAT only | OAuth Device Flow |
| Webhooks | No | Yes (smee.io) |
| Install | Docker | npx |
Expand Down
Loading