Prerequisites

Install dependencies

pnpm install

📥 Installation

Local Setup

```bash

Build all packages

pnpm build

Building

```bash

Build all packages

pnpm build

Build specific package

pnpm --filter @nirholas/github-to-mcp build pnpm --filter @github-to-mcp/openapi-parser build pnpm --filter web build ```

🚀 Quick Start

📖 Usage

Basic usage

node packages/core/dist/cli.mjs https://github.com/owner/repo

Use Cases & Applications Keywords

trading bot, DeFi agent, yield optimizer, data oracle, price feed, analytics agent, research agent, coding agent, development agent, automation agent, task agent, workflow agent, portfolio management, asset management, supply chain, service agent, API service, chatbot, AI assistant, virtual assistant, personal agent, enterprise agent, B2B agent, agent-as-a-service, AaaS, SaaS agent, AI SaaS, delegated agent, proxy agent, helper agent, worker agent, coordinator agent, orchestrator agent, validator agent, auditor agent, insurance agent, scoring agent, ranking agent

⚙️ Configuration

🔐 Environment Variables

GitHub Token

Without a token, GitHub API requests are limited to 60 per hour. With a token, the limit increases to 5,000 per hour. For private repositories, a token with appropriate access is required.

Create a token at: https://github.com/settings/tokens

Required scopes: - repo (for private repositories) - public_repo (for public repositories only)

🎛️ Generator Options

When using the programmatic API, you can configure:

const generator = new GithubToMcpGenerator({
  // Authentication
  githubToken: process.env.GITHUB_TOKEN,
  
  // Extraction sources to enable
  sources: ['openapi', 'readme', 'code', 'graphql', 'grpc', 'mcp'],
  
  // Output configuration
  outputLanguage: 'typescript', // or 'python', 'go'
  
  // Tool filtering
  includeUniversalTools: true,
  maxTools: 100,
  
  // Repository options
  branch: 'main', // specific branch to analyze
});

---

Configuration Files

Each generated server includes:

---

💻 CLI (One Command)

npx @nirholas/github-to-mcp https://github.com/stripe/stripe-node

Using the Web Interface

The web application is deployed at github-to-mcp.vercel.app. Use the browser-based interface without any local installation.

---

🌐 Web Interface

The web interface provides the simplest way to convert repositories:

1. Navigate to the web application
2. Enter a GitHub repository URL (e.g., https://github.com/owner/repo)
3. Optionally configure extraction options
4. Click "Generate" to analyze the repository
5. Review the generated tools and code
6. Download the MCP server package or copy the configuration

The web interface also provides an interactive playground where you can test generated tools before downloading.

💻 Command Line Interface

After building the project locally, you can use the CLI:

```bash

📦 Programmatic API

Import the generator in your own TypeScript or JavaScript code:

import { GithubToMcpGenerator } from '@nirholas/github-to-mcp';

const generator = new GithubToMcpGenerator({
  githubToken: process.env.GITHUB_TOKEN,
  sources: ['openapi', 'readme', 'code'],
  outputLanguage: 'typescript'
});

const result = await generator.generate('https://github.com/owner/repo');

console.log(`Repository: ${result.name}`);
console.log(`Classification: ${result.classification.type}`);
console.log(`Generated ${result.tools.length} tools`);

// Access the generated code
console.log(result.code);

// Save to disk
await result.save('./output-directory');

<details> <summary><strong>📋 Generator Options Interface</strong></summary>

interface GithubToMcpOptions {
  // GitHub personal access token for API authentication
  githubToken?: string;
  
  // Which sources to extract tools from
  // Default: ['openapi', 'readme', 'code', 'graphql', 'mcp']
  sources?: Array<'openapi' | 'readme' | 'code' | 'graphql' | 'grpc' | 'mcp'>;
  
  // Output language for generated server
  // Default: 'typescript'
  outputLanguage?: 'typescript' | 'python' | 'go';
  
  // Include universal tools (read_file, list_files, etc.)
  // Default: true
  includeUniversalTools?: boolean;
  
  // Maximum number of tools to generate
  // Default: 100
  maxTools?: number;
  
  // Specific branch to analyze
  // Default: repository's default branch
  branch?: string;
}

</details>

---

API Specifications

Endpoints & Integration Keywords

endpoint, agent endpoint, service endpoint, API endpoint, MCP endpoint, A2A endpoint, web endpoint, HTTPS endpoint, HTTP endpoint, DID, decentralized identifier, ENS, Ethereum Name Service, ENS name, agent.eth, vitalik.eth, email endpoint, OASF, Open Agent Specification Format, endpoint verification, domain verification, endpoint ownership, .well-known, well-known, agent-registration.json, endpoint domain, endpoint URL, endpoint URI, base64 data URI, on-chain metadata, off-chain metadata, metadata storage, JSON metadata, agent JSON, registration JSON

SDK & Developer Tools Keywords

SDK, Agent0 SDK, Agent0, ChaosChain SDK, ChaosChain, Lucid Agents, Daydreams AI, create-8004-agent, npm, TypeScript SDK, Python SDK, JavaScript, Solidity, smart contract, ABI, contract ABI, deployed contracts, contract addresses, Hardhat, development tools, developer tools, dev tools, API, REST API, GraphQL, subgraph, The Graph, indexer, blockchain explorer, Etherscan, contract verification, open source, MIT license, CC0, public domain, GitHub, repository, code repository, documentation, docs, best practices, reference implementation

💻 VS Code with Continue

If using the Continue extension for VS Code:

{
  "models": [...],
  "mcpServers": {
    "my-repo": {
      "command": "node",
      "args": ["/path/to/server.mjs"]
    }
  }
}

Competitor & Alternative Keywords

agent framework, agent platform, AI platform, centralized agents, closed agents, proprietary agents, gatekeeper, intermediary, platform lock-in, vendor lock-in, data silos, walled garden, open alternative, decentralized alternative, permissionless alternative, trustless alternative

🔧 Troubleshooting

<details> <summary><strong>❌ "Rate limit exceeded" errors</strong></summary>

Provide a GitHub token:

export GITHUB_TOKEN=ghp_xxxxxxxxxxxx

</details>

<details> <summary><strong>❌ "Repository not found" errors</strong></summary>

• Verify the URL is correct
• For private repositories, ensure your token has repo scope
• Check that the repository exists and is accessible

</details>

<details> <summary><strong>❌ "No tools extracted" results</strong></summary>

• Verify the repository contains API definitions or documented endpoints
• Try enabling all extraction sources: --sources openapi,readme,code,graphql,mcp
• Check that specification files follow standard naming conventions

</details>

<details> <summary><strong>❌ Generated server fails to start</strong></summary>

• Ensure Node.js 22+ is installed
• Run npm install in the generated directory
• Check for TypeScript compilation errors with npx tsc --noEmit

</details>

<details> <summary><strong>❌ Claude Desktop does not show the server</strong></summary>

• Verify the path in claude_desktop_config.json is absolute
• Restart Claude Desktop after configuration changes
• Check Claude Desktop logs for connection errors

</details>

---