GitHub Mapper MCP Server

Integrations

  • Provides tools for mapping and analyzing GitHub repositories, including setting authentication tokens, retrieving repository structures, and accessing summary information like stars, forks, language, and update dates.

GitHub Mapper MCP Server

GitHub Mapper is a Model Context Protocol (MCP) server that provides tools for mapping and analyzing GitHub repositories. It allows users to set a GitHub Personal Access Token and retrieve detailed information about a specified repository, including its structure and summary statistics.

Features

  • Set GitHub Personal Access Token for authentication
  • Map and analyze GitHub repository structure
  • Retrieve repository summary information (stars, forks, language, etc.)
  • Provide a detailed repository file structure

Prerequisites

  • Node.js (v18.0.0 or later recommended)
  • npm (comes with Node.js)
  • A GitHub Personal Access Token with appropriate permissions

Installation

Installing via Smithery

To install GitHub Mapper for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install github-mapper-mcp-server --client claude

Manual Installation

  1. Clone the repository:
    git clone https://github.com/your-username/github-mapper-mcp-server.git cd github-mapper-mcp-server
  2. Install dependencies:
    npm install
  3. Build the project:
    npm run build

Usage

  1. Start the server:
    npm start
  2. The server will run on stdio, allowing it to communicate with MCP clients.

Available Tools

1. set-github-token

Sets the GitHub Personal Access Token for authentication.

  • Create your Personal Access Token here. Choose Tokens (classic). Scopes: repo

Example, in your IDE or Claude Desktop:

Please set-github-token to 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

2. map-github-repo

Maps a GitHub repository structure and provides summary information.

Example:

Please map-github-repo https://github.com/dazeb/MCP-Github-Mapper

Manual install in Cline or Roo-Cline MCP Client:

{ "mcpServers": { "github-mapper": { "command": "node", "args": ["/home/user/Documents/Cline/MCP/github-mapper/build/index.js"] } } }

Example Output

Repository Analysis Summary: Name: Hello-World Description: My first repository on GitHub! Stars: 1234 Forks: 567 Primary Language: JavaScript Created: 2023-01-01 Last Updated: 2023-06-15 Repository Structure: { "src": { "components": { "Header.js": null, "Footer.js": null }, "pages": { "index.js": null, "about.js": null }, "styles": { "global.css": null } }, "public": { "images": { "logo.png": null }, "favicon.ico": null }, "package.json": null, "README.md": null }

Images

Running evals

The evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the npx command. Full documentation can be found here.

OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts

Error Handling

  • If the GitHub token is not set, you'll receive an error message prompting you to use the set-github-token tool first.
  • Invalid GitHub URLs or repository paths will result in appropriate error messages.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License.

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides tools for mapping and analyzing GitHub repositories. It allows users to set a GitHub Personal Access Token and retrieve detailed information about a specified repository, including its structure and summary statistics.

  1. Features
    1. Prerequisites
      1. Installation
        1. Installing via Smithery
        2. Manual Installation
      2. Usage
        1. Available Tools
          1. 1. set-github-token
          2. 2. map-github-repo
        2. Manual install in Cline or Roo-Cline MCP Client:
          1. Example Output
            1. Images
              1. Running evals
                1. Error Handling
                  1. Contributing
                    1. License

                      Related MCP Servers

                      • -
                        security
                        F
                        license
                        -
                        quality
                        Enables interaction with GitHub through the GitHub API, supporting file operations, repository management, advanced search, and issue tracking with comprehensive error handling and automatic branch creation.
                        Last updated -
                        9
                        1
                        TypeScript
                      • -
                        security
                        F
                        license
                        -
                        quality
                        Provides tools for interacting with GitHub's API through the MCP protocol, allowing users to create repositories, push content, and retrieve user information.
                        Last updated -
                        JavaScript
                      • -
                        security
                        F
                        license
                        -
                        quality
                        Enables comprehensive GitHub operations through natural language including file management, repository administration, issue tracking, and advanced code searching.
                        Last updated -
                        22,912
                        1
                        TypeScript
                      • A
                        security
                        F
                        license
                        A
                        quality
                        Provides GitHub data analysis for repositories, developers, and organizations, enabling insights into open source ecosystems through API calls and natural language queries.
                        Last updated -
                        5
                        2
                        JavaScript

                      View all related MCP servers

                      ID: sgs5limagp