GitHub Explorer MCP

What is GitHub Explorer MCP?

GitHub Explorer MCP is a Model Context Protocol (MCP) server that provides GitHub repository information—including file content, directory structure, and other metadata—for MCP clients such as Claude Desktop and Cursor. It is built for developers who need to query GitHub repositories programmatically through AI assistants.

How to use GitHub Explorer MCP?

Install the npm package globally, then run github-explorer-mcp (stdio mode) or github-explorer-mcp-sse (HTTP/SSE mode). Configure MCP clients (e.g., Claude Desktop, Cursor) by adding a JSON entry pointing to the npx command. Alternatively, build and run from source or use Docker.

Key features of GitHub Explorer MCP

• Retrieve comprehensive repository summaries (stars, forks, description, last updated)
• View directory structure as an ASCII tree visualization
• Access content of specific files in a repository
• Clone repositories locally for faster processing
• Cache repository data to reduce API calls
• Output data in text or structured JSON format
• Provide progress notifications for long-running operations
• Basic web status page when running in HTTP mode

Use cases of GitHub Explorer MCP

• An AI assistant fetching repository metadata to answer user questions about a project
• Examining a repository’s file structure before writing code contributions
• Reading key files (README, configuration) from multiple repositories in a single session
• Automating repository analysis workflows within MCP-compatible IDEs

FAQ from GitHub Explorer MCP

What runtime does GitHub Explorer MCP require?

It requires Node.js 18 or newer because it uses modern Web APIs like ReadableStream.

Can I use HTTP mode instead of stdio?

Yes; run github-explorer-mcp-sse to start the server in HTTP/SSE mode, which also provides a basic web status page.

How does the caching system work?

The server efficiently caches repository data to reduce the number of GitHub API calls made during repeated queries.

Are there any planned tools not yet available?

Yes; git_search and git_diff are listed as "Coming Soon" but are not yet implemented.

How do I contribute to GitHub Explorer MCP?

Contributions are welcome via Pull Requests on the project’s repository (licensed under MIT).