GitHub Repo Extractor

by kazuph

6 stars

2k downloads

Not rated

GitHub

About

Connects to GitHub repositories, enabling natural language queries about code structure, dependencies, and development history.

Details

Author: kazuph
Repository: kazuph/mcp-github-pera1
GitHub stars: 6
Downloads: 1,997
License: MIT License
Categories: Productivity, Developer Tools, Design, Workplace, AI, Communication, Infrastructure, Knowledge Base

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name GitHub Repo Extractor

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 @kazuph/mcp-github-pera1
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "github repo extractor": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "-y",
                "@kazuph/mcp-github-pera1"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "github repo extractor": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@kazuph/mcp-github-pera1"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "github repo extractor": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "-y",
                "@kazuph/mcp-github-pera1"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "github repo extractor": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "-y",
                "@kazuph/mcp-github-pera1"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "github repo extractor": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@kazuph/mcp-github-pera1"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "github repo extractor": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "-y",
                "@kazuph/mcp-github-pera1"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "github repo extractor": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "-y",
                "@kazuph/mcp-github-pera1"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "github repo extractor": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@kazuph/mcp-github-pera1"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "github repo extractor": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "-y",
                "@kazuph/mcp-github-pera1"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "github repo extractor": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "-y",
                "@kazuph/mcp-github-pera1"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "github repo extractor": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@kazuph/mcp-github-pera1"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "github repo extractor": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "-y",
                "@kazuph/mcp-github-pera1"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "github repo extractor": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "-y",
                "@kazuph/mcp-github-pera1"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "github repo extractor": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@kazuph/mcp-github-pera1"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "github repo extractor": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "-y",
                "@kazuph/mcp-github-pera1"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

From the repository

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.

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

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "github repo extractor": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "-y",
                "@kazuph/mcp-github-pera1"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Linux

{
    "cwd": "~/Library/Application Support/Claude",
    "env": [],
    "args": [
        "-y",
        "@kazuph/mcp-github-pera1"
    ],
    "shell": false,
    "command": "npx"
}

Macos

{
    "cwd": "~/Library/Application Support/Claude",
    "env": [],
    "args": [
        "-y",
        "@kazuph/mcp-github-pera1"
    ],
    "shell": false,
    "command": "npx"
}

Windows

{
    "cwd": "~/Library/Application Support/Claude",
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@kazuph/mcp-github-pera1"
    ],
    "shell": false,
    "command": "cmd"
}

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)

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

GitHub Repo Extractor

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

Claude Desktop / Cursor

Linux

Macos

Windows

GitHub MCP Server for Pera1

Setup

Parameters

Usage Examples

License

Author

Install

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

Linux

Macos

Windows

GitHub MCP Server for Pera1

Setup

Parameters

Usage Examples

License

Author

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7