GitHub MCP Server for Pera1

A Model Context Protocol server that connects GitHub code to Claude.ai. This server utilizes the Pera1 service to extract code from GitHub repositories and provide better context to Claude.

Setup

Add the following to your MCP config file (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-github-pera1"]
    }
  }
}

Now you can ask Claude about GitHub code repositories.

Parameters

url: GitHub repository URL (required)
dir: Filter files by directory paths (comma-separated)
ext: Filter files by extensions (comma-separated)
mode: Display mode (e.g., tree shows directory structure and README files only)
branch: Specify the branch to fetch from
file: Specify a single file to retrieve

Usage Examples

You can ask Claude questions like:

Tell me about the implementation of GitHub repository https://github.com/username/repository

For specific directories:

Explain the components in https://github.com/username/repository?dir=src/components

For a specific file:

Show me the Button component from https://github.com/username/repository?file=src/components/Button.tsx

For directory structure with README files only:

Show me the structure of https://github.com/username/repository?mode=tree

For a specific branch:

Analyze the develop branch of https://github.com/username/repository?branch=develop

License

MIT

Author

kazuph (https://x.com/kazuph)