Update installation guide for GitHub MCP server in Claude...

...applications, emphasizing Docker usage and deprecating NPX.

Author: D1M1TR10S

docs/installation-guides/install-claude.md

@@ -1,6 +1,6 @@
 # Install GitHub MCP Server in Claude Applications
 
-This guide covers installation for both Claude Code CLI and Claude Desktop applications.
+This guide covers installation of the GitHub MCP server for both Claude Code CLI and Claude Desktop applications.
 
 ## Claude Code CLI
 
@@ -10,21 +10,28 @@ Claude Code CLI provides command-line access to Claude with MCP server integrati
 
 1. Claude Code CLI installed
 2. [GitHub Personal Access Token](https://github.com/settings/personal-access-tokens/new)
-3. Node.js/npm or Docker (depending on installation method)
+3. [Docker](https://www.docker.com/) installed and running
 
-### Installation Methods
+### Installation
+
+Run the following command to add the GitHub MCP server using Docker:
 
-#### Method 1: Using Docker (Recommended)
 ```bash
-claude mcp add-json github '{"command": "docker", "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"], "env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_pat"}}'
+claude mcp add github -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server
+```
+
+Then set the environment variable:
+```bash
+claude mcp update github -e GITHUB_PERSONAL_ACCESS_TOKEN=your_github_pat
 ```
 
-#### Method 2: Using NPX (Legacy)
-Note: The npm package has moved to GitHub's official repository but remains functional.
+Or as a single command with the token inline:
 ```bash
-claude mcp add-json github '{"command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_pat"}}'
+claude mcp add-json github '{"command": "docker", "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"], "env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_pat"}}'
 ```
 
+**Important**: The npm package `@modelcontextprotocol/server-github` is no longer supported as of April 2025. Use the official Docker image `ghcr.io/github/github-mcp-server` instead.
+
 ### Configuration Options
 
 - Use `-s user` to add the server to your user configuration (available across all projects)
@@ -48,17 +55,15 @@ Claude Desktop provides a graphical interface for interacting with the GitHub MC
 
 1. Claude Desktop installed
 2. [GitHub Personal Access Token](https://github.com/settings/personal-access-tokens/new)
-3. Node.js/npm or Docker (depending on installation method)
+3. [Docker](https://www.docker.com/) installed and running
 
 ### Configuration File Location
 
 - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
 - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
 - **Linux**: `~/.config/Claude/claude_desktop_config.json` (unofficial support)
 
-### Installation Methods
-
-#### Method 1: Using Docker (Recommended)
+### Installation
 
 Add the following to your `claude_desktop_config.json`:
 
@@ -83,23 +88,7 @@ Add the following to your `claude_desktop_config.json`:
 }
 ```
 
-#### Method 2: Using NPX (Legacy)
-
-Note: The npm package has moved to GitHub's official repository but remains functional.
-
-```json
-{
-  "mcpServers": {
-    "github": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-github"],
-      "env": {
-        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_pat"
-      }
-    }
-  }
-}
-```
+**Important**: The npm package `@modelcontextprotocol/server-github` is no longer supported as of April 2025. Use the official Docker image `ghcr.io/github/github-mcp-server` instead.
 
 ### Using Environment Variables
 
@@ -148,8 +137,7 @@ After restarting, you should see:
 
 ### Claude Code CLI
 - Verify the command syntax is correct (note the single quotes around the JSON)
-- Check that Node.js/npm is installed: `node --version`
-- For Docker method, ensure Docker is running
+- Ensure Docker is running: `docker --version`
 - Use `/mcp` command within Claude Code to check server status
 
 ### Claude Desktop
@@ -158,13 +146,13 @@ After restarting, you should see:
   - **Windows**: `%APPDATA%\Claude\logs\`
 - Look for `mcp-server-github.log` for server-specific errors
 - Ensure configuration file is valid JSON
-- Try running the command manually in terminal to diagnose issues
+- Try running the Docker command manually in terminal to diagnose issues
 
 ### Common Issues
 - **Invalid JSON**: Validate your configuration at [jsonlint.com](https://jsonlint.com)
 - **PAT issues**: Ensure your GitHub PAT has required scopes
 - **Docker not found**: Install Docker Desktop and ensure it's running
-- **NPX not found**: Install Node.js from [nodejs.org](https://nodejs.org)
+- **Docker image pull fails**: Try `docker logout ghcr.io` then retry
 
 ---