# 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.

<a href="https://glama.ai/mcp/servers/m2sd6ew3wf"><img width="380" height="200" src="https://glama.ai/mcp/servers/m2sd6ew3wf/badge" alt="@kazuph/mcp-github-pera1 MCP server" /></a>

### Setup

Add the following to your MCP config file (`~/Library/Application Support/Claude/claude_desktop_config.json`):
```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)