Skip to main content
Glama
@kazuph/mcp-github-pera1

@kazuph/mcp-github-pera1

by kazuph

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)

Available Tools

1 tool
github_get_codeA

Retrieves code from a GitHub repository URL and combines it into a single file. The URL must start with "https://".

Query Parameters:

  • dir: Filter files by directory paths (comma-separated) Example: ?dir=src/components,tests/unit

  • ext: Filter files by extensions (comma-separated) Example: ?ext=ts,tsx,js

  • mode: Display mode Example: ?mode=tree (Shows directory structure and README files only)

  • branch: Specify the branch to fetch from (optional) Example: ?branch=feature/new-feature

  • file: Specify a single file to retrieve (optional) Example: ?file=src/components/Button.tsx

Examples:

  1. For GitHub tree URLs with branch: https://github.com/kazuph/pera1/tree/feature/great-branch This URL will be automatically parsed to extract the branch information.

  2. For specific directory in a branch: url: https://github.com/modelcontextprotocol/servers dir: src/fetch branch: develop

  3. For a single file: url: https://github.com/username/repository file: src/components/Button.tsx

  4. For directory structure with README files only: url: https://github.com/username/repository mode: tree

The tool will correctly parse the repository structure and fetch the files from the specified branch.

Inputs: url (required), dir, ext, mode, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is no risk of confusion between tools.

    Naming Consistency5/5

    The single tool follows a consistent verb_noun pattern (github_get_code).

    Tool Count2/5

    A single tool for code retrieval is very minimal; users might expect additional GitHub operations, making the server feel incomplete.

    Completeness4/5

    For the stated purpose of retrieving code from a GitHub repository, the tool covers key needs with filtering by directory, extension, branch, and single file, as well as a tree mode. Minor gap: no support for private repos or authentication details in the description.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      A Model Context Protocol server that provides comprehensive GitHub integration for Claude Desktop, allowing users to manage repositories, issues, and pull requests. It supports file operations, branch management, and repository searches through natural language commands.
      489 npm
      -