Log inSubmit server
GitHub to MCP Converter logo

GitHub to MCP Converter

Generates runnable MCP servers from GitHub repositories by extracting APIs, code functions, commands, and documentation.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install GitHub to MCP Converter

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "github-to-mcp-converter": {
      "command": "npx",
      "args": [
        "-y",
        "@nirholas/github-to-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @nirholas/github-to-mcp

Process exited before answering initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 8d ago.

Overview

GitHub to MCP Converter MCP server turns a GitHub repository into a generated MCP server for AI assistants. It fetches and classifies repository contents, extracts tools from OpenAPI, GraphQL, gRPC, source code, MCP definitions, and README files, then produces TypeScript, Python, or Go output. Use it when an agent needs structured access to a repository’s files, code, documented commands, or exposed API operations. Generation is available through a web interface, CLI, or TypeScript API.

Use cases

  • Generate an MCP interface for a GitHub API repository
  • Expose documented CLI commands to an AI assistant
  • Extract GraphQL operations as callable MCP tools
  • Create a local MCP package from a codebase
  • Inspect generated tools before downloading a server

Key features

  • Repository type classification
  • OpenAPI, GraphQL, gRPC, and AsyncAPI extraction
  • Source-code and README tool discovery
  • TypeScript, Python, and Go output
  • CLI, web, and programmatic interfaces
  • Generated client configuration and Docker templates

Tools2

What GitHub to MCP Converter lets your agent do. Expand a tool for its parameters.

Self-reported~16 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

4/4 checks healthy over the last 19d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 18h ago via OSV.dev · @nirholas/github-to-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars34Stargazers on the source repository.
npm downloads35Package downloads in the last 30 days.
Last commit7d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed2Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How GitHub to MCP Converter works

What GitHub to MCP Converter MCP server does

GitHub to MCP Converter MCP server analyzes a repository and creates an MCP server package from the interfaces and documentation it finds. It can inspect repositories written in TypeScript, JavaScript, Python, Go, Java, Kotlin, Rust, Ruby, C#, or F#, then generate output in TypeScript, Python, or Go.

The generated server can expose repository-oriented tools such as file reading, code search, and directory listing. Python functions marked with @mcp.tool are preserved during extraction.

How it works

The GitHub to MCP Converter MCP server follows a repository-to-package workflow. It retrieves the repository, classifies its type, and examines configured extraction sources. Supported sources include OpenAPI, README files, source code, GraphQL, gRPC, and existing MCP definitions.

Discovered interfaces are converted into MCP tools with parameters and, where applicable, input validation. The generator then writes runnable server code, dependencies, type definitions for generated tools, and client configuration files. Results can be inspected in the web interface, tested through its interactive playground, downloaded, or saved to a local directory through the API or CLI.

Setup and configuration

The web application accepts a GitHub repository URL and provides generation without a local installation. For local use, clone the repository, install dependencies with pnpm, and build the project. The package can also be invoked with npx @nirholas/github-to-mcp <repository-url>.

The CLI accepts an output directory, an output language, and a comma-separated list of extraction sources. The programmatic TypeScript API accepts the same types of settings through GithubToMcpOptions, including githubToken, sources, and outputLanguage.

Set GITHUB_TOKEN when accessing private repositories or when higher GitHub API rate limits are needed. The generated package may also include Docker deployment templates and configuration for Claude Desktop, Cursor, and other MCP clients.

Tools and capabilities

  • Classifies repositories as API projects, libraries, CLI tools, MCP servers, or documentation repositories.
  • Detects and parses OpenAPI and Swagger specifications.
  • Extracts GraphQL schemas and creates query and mutation tools.
  • Parses gRPC and Protobuf service definitions and supports AsyncAPI specifications.
  • Finds functions, HTTP routes, README-documented commands, and existing MCP tools.
  • Produces TypeScript, Python, or Go MCP server code with dependencies.
  • Provides a generated tool list, source code, configuration, and a save-to-disk operation.

Limitations and notes

Generated capabilities depend on what the source repository contains and which extraction sources are enabled. The project does not guarantee that every repository will expose the same tool types. Its supported input languages and generated output languages are distinct: repositories may use several languages, while generated servers are limited to the listed TypeScript, Python, and Go targets.

The GitHub to MCP Converter MCP server is a generator rather than a fixed connector with one predefined tool set. Review the generated tools and code before deploying them, particularly when extraction is based on documentation or source-code analysis. Private repository access requires a GitHub token, and the web interface, CLI, and programmatic API are separate ways to run generation.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about GitHub to MCP Converter

GitHub to MCP Converter is an MCP server that connects GitHub repositories with AI assistants by generating tools for repository files, code search, directory listing, documented commands, and discovered API operations. It extracts interfaces from OpenAPI, GraphQL, source code, README files, gRPC, and MCP definitions, then outputs a runnable server.

Install it from source or run the published package with npx. From source, clone the repository, run `pnpm install`, and run `pnpm build`; for a direct invocation, use `npx @nirholas/github-to-mcp <repository-url>`. The web application is another option that requires no local installation.

Yes, it generates configuration for Cursor. After entering a repository through the web interface or running the CLI or API, review the generated package and use its client configuration with Cursor. The README also names Claude Desktop and other MCP clients as supported configuration targets.

Yes, private repository access is supported when you provide a GitHub token. Set `GITHUB_TOKEN` for the CLI or pass `githubToken` through the programmatic API. The token can also be used for higher GitHub API rate limits.

Related MCP servers

All in Version Control All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGitHub to MCP Converter AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/github-to-mcp-converter?style=directory)](https://allmcps.com/mcp/github-to-mcp-converter)
HTML Embed
<a href="https://allmcps.com/mcp/github-to-mcp-converter"><img src="https://allmcps.com/api/badge/github-to-mcp-converter?style=directory" alt="GitHub to MCP Converter on AllMCPs" /></a>