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

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

Usage

Start the server:
npm start
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.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

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.

Tools

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

OSSInsight MCP Server
damonxue
A
security
A
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
13
JavaScript
MIT License
GitHub Enterprise MCP Server
piyushgIITian
-
security
A
license
-
quality
Enables interaction with GitHub repositories through the GitHub API, allowing file operations, repository management, issue tracking, and code search through natural language commands.
Last updated -
7
2
TypeScript
MIT License
GitHub Repository Analyzer
jar285
-
security
F
license
-
quality
Enables 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
GitHub MCP Tools
Pranesh-2005
-
security
F
license
-
quality
A 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

View all related MCP servers

GitHub Mapper MCP Server