This GitHub Mapper MCP Server allows you to map and analyze GitHub repositories with authentication and detailed structure insights:
- Set GitHub Personal Access Token: Authenticate requests using the
set-github-token
tool. - Map GitHub Repository Structure: Analyze repositories to retrieve their structure and organization.
- Access Repository Information: Get summary data (stars, forks, primary language, dates) and detailed file structure.
- Error Handling: Receive clear messages for authentication issues or invalid URLs.
- Integration Support: Works seamlessly with MCP clients like Cline or Roo-Cline.
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:
Manual Installation
- Clone the repository:
- Install dependencies:
- Build the project:
Usage
- Start the server:
- 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:
2. map-github-repo
Maps a GitHub repository structure and provides summary information.
Example:
Manual install in Cline or Roo-Cline MCP Client:
Example Output
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.
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.
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.
Related MCP Servers
- AsecurityAlicenseAqualityProvides GitHub data analysis for repositories, developers, and organizations, enabling insights into open source ecosystems through API calls and natural language queries.Last updated -513JavaScriptMIT License
- -securityAlicense-qualityEnables interaction with GitHub repositories through the GitHub API, allowing file operations, repository management, issue tracking, and code search through natural language commands.Last updated -72TypeScriptMIT License
- -securityFlicense-qualityEnables Large Language Models to analyze GitHub repositories in real-time, providing tools for retrieving repository information, analyzing issues, accessing documentation, and visualizing activity.Last updated -Python
- -securityFlicense-qualityA set of tools allowing AI assistants to interact directly with GitHub, enabling automation of tasks like fetching user profiles, creating repositories, and managing pull requests.Last updated -Python