How do I install the Github To MCP Guide skill?

Run npx skillmds@latest add nirholas/github-to-mcp-guide in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Github To MCP Guide safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Github To MCP Guide?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Github To MCP Guide free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Github To MCP Guide?

nirholas (@nirholas) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Github To MCP Guide by nirholas — Agent Skill

Name: Github To MCP Guide
Author: nirholas

Github To MCP Guide

Guide to converting GitHub repositories into MCP servers automatically. Extract tools from OpenAPI, GraphQL, and REST APIs for Claude Desktop, Cursor, Windsurf, Cline, and VS Code. AI-powered code generation creates type-safe TypeScript/Python MCP servers. Zero config — just paste a repo URL.

nirholas d377546 3.2 KB Updated Sep 17, 2026

File contents

GitHub-to-MCP Conversion Guide

Convert any GitHub repository into an MCP server automatically. The tool analyzes the repo's API surface (OpenAPI specs, GraphQL schemas, REST endpoints) and generates a working MCP server with type-safe tools.

How It Works

GitHub Repo URL
    │
    ▼
1. Clone & analyze repo
    │
    ▼
2. Detect API surface
   ├── OpenAPI/Swagger specs
   ├── GraphQL schemas
   ├── REST route definitions
   └── Function exports
    │
    ▼
3. Generate MCP server
   ├── TypeScript or Python
   ├── Type-safe tool definitions
   ├── Parameter validation
   └── Error handling
    │
    ▼
4. Ready-to-use MCP server

Quick Start

npx github-to-mcp https://github.com/owner/repo

This generates a ready-to-use MCP server in ./mcp-output/.

Supported API Formats

Format	Detection	Example
OpenAPI 3.x	`openapi.json`, `swagger.yaml`	REST APIs with full schema
GraphQL	`schema.graphql`, introspection	Query/mutation → tools
Express/Fastify	Route scanning	`app.get('/api/...')` → tools
Next.js API	Route file detection	`app/api/*/route.ts` → tools
Function exports	Named export analysis	`export function doThing()` → tools

Output Options

TypeScript MCP Server

github-to-mcp https://github.com/owner/repo --lang typescript

Generates a Node.js MCP server with full TypeScript types.

Python MCP Server

github-to-mcp https://github.com/owner/repo --lang python

Generates a Python MCP server using the official MCP SDK.

AI-Powered Generation

When the API surface is ambiguous, the tool uses AI (GPT-4 or Claude) to:

Infer parameter types from usage patterns
Generate meaningful tool descriptions
Create example inputs for each tool
Handle edge cases in API design

Use Cases

Turn a DeFi Protocol into MCP Tools

github-to-mcp https://github.com/aave/aave-v3-core
# → Generates MCP tools for supply, borrow, repay, liquidate, etc.

Convert a Data API

github-to-mcp https://github.com/nirholas/crypto-data-aggregator
# → Generates MCP tools for price queries, portfolio tracking, alerts

Make Internal Tools AI-Accessible

github-to-mcp https://github.com/your-company/internal-api
# → Your internal API is now accessible to AI agents

Integration with SperaxOS

github-to-mcp is particularly useful for the SperaxOS ecosystem:

Convert DeFi protocol repos into MCP tools
Auto-generate tool manifests for the skill marketplace
Create agent tools from any Sperax ecosystem repo

Links

GitHub: https://github.com/nirholas/github-to-mcp
MCP Specification: https://modelcontextprotocol.io
SperaxOS: https://github.com/nirholas/sperax

---name: github-to-mcp-guidedescription: Guide to converting GitHub repositories into MCP servers automatically. Extract tools from OpenAPI, GraphQL, and REST APIs for Claude Desktop, Cursor, Windsurf, Cline, and VS Code. AI-powered code generation creates type-safe TypeScript/Python MCP servers. Zero config — just paste a repo URL.license: MIT---# GitHub-to-MCP Conversion GuideConvert any GitHub repository into an MCP server automatically. The tool analyzes the repo's API surface (OpenAPI specs, GraphQL schemas, REST endpoints) and generates a working MCP server with type-safe tools.## How It Works```GitHub Repo URL │ ▼1. Clone & analyze repo │ ▼2. Detect API surface ├── OpenAPI/Swagger specs ├── GraphQL schemas ├── REST route definitions └── Function exports │ ▼3. Generate MCP server ├── TypeScript or Python ├── Type-safe tool definitions ├── Parameter validation └── Error handling │ ▼4. Ready-to-use MCP server```## Quick Start```bashnpx github-to-mcp https://github.com/owner/repo```This generates a ready-to-use MCP server in `./mcp-output/`.## Supported API Formats| Format | Detection | Example ||--------|-----------|---------|| **OpenAPI 3.x** | `openapi.json`, `swagger.yaml` | REST APIs with full schema || **GraphQL** | `schema.graphql`, introspection | Query/mutation → tools || **Express/Fastify** | Route scanning | `app.get('/api/...')` → tools || **Next.js API** | Route file detection | `app/api/*/route.ts` → tools || **Function exports** | Named export analysis | `export function doThing()` → tools |## Output Options### TypeScript MCP Server```bashgithub-to-mcp https://github.com/owner/repo --lang typescript```Generates a Node.js MCP server with full TypeScript types.### Python MCP Server```bashgithub-to-mcp https://github.com/owner/repo --lang python```Generates a Python MCP server using the official MCP SDK.## AI-Powered GenerationWhen the API surface is ambiguous, the tool uses AI (GPT-4 or Claude) to:- Infer parameter types from usage patterns- Generate meaningful tool descriptions- Create example inputs for each tool- Handle edge cases in API design## Use Cases### Turn a DeFi Protocol into MCP Tools```bashgithub-to-mcp https://github.com/aave/aave-v3-core# → Generates MCP tools for supply, borrow, repay, liquidate, etc.```### Convert a Data API```bashgithub-to-mcp https://github.com/nirholas/crypto-data-aggregator# → Generates MCP tools for price queries, portfolio tracking, alerts```### Make Internal Tools AI-Accessible```bashgithub-to-mcp https://github.com/your-company/internal-api# → Your internal API is now accessible to AI agents```## Integration with SperaxOSgithub-to-mcp is particularly useful for the SperaxOS ecosystem:- Convert DeFi protocol repos into MCP tools- Auto-generate tool manifests for the skill marketplace- Create agent tools from any Sperax ecosystem repo## Links- GitHub: https://github.com/nirholas/github-to-mcp- MCP Specification: https://modelcontextprotocol.io- SperaxOS: https://github.com/nirholas/sperax

Frequently asked questions