Smithery MCP Server Test

🚀 GitHub MCP Server

The GitHub MCP Server provides search capabilities for code, issues, and users on GitHub, and can be easily integrated with Claude Desktop.

🚀 Quick Start

✨ Features

Code Search

• language:javascript: Search by programming language.
• repo:owner/name: Search within a specific repository.
• path:app/src: Search by path.
• extension:js: Search by file extension.
• Example: q: "import express" language:typescript path:src/

Issue Search

• is:issue or is:pr: Filter by type.
• is:open or is:closed: Filter by status.
• label:bug: Filter by label.
• author:username: Filter by author.
• Example: q: "memory leak" is:issue is:open label:bug

User Search

• type:user or type:org: Filter by account type.
• followers:>1000: Filter by the number of followers.
• location:London: Filter by location.
• Example: q: "fullstack developer" location:London followers:>100

For detailed search syntax, please refer to GitHub's Search Documentation.

📦 Installation

Personal Access Token

Create a GitHub personal access token and grant appropriate permissions:

• Visit Personal Access Tokens (in GitHub Settings > Developer Settings).
• Select the repositories you want this token to access (public, all, or selected).
• Create a token with the repo scope ("Full control of private repositories").
  • If you only use it with public repositories, you can choose the public_repo scope.
• Copy the generated token.

Usage with Claude Desktop

To use this feature in Claude Desktop, add the following to your claude_desktop_config.json:

Docker

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "mcp/github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

🔧 Technical Details

Build

Docker build:

docker build -t mcp/github -f src/github/Dockerfile .

📄 License

This MCP server is released under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please refer to the LICENSE file in the project repository.