skills.rest
nirholas
nirholasCOMMUNITY
Explore all skills by this author →
Website𝕏@nichxbtGitHub

github-to-mcp-guide

Convert GitHub repository APIs into type-safe MCP server tools.

5|Updated May 2, 2026
Search Tags:#typescript#openapi#github#graphql#mcp#api extraction#tool generation
One-click install
npx skills add https://github.com/nirholas/three-ui --skill github-to-mcp-guide
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-to-mcp-guide
Source: https://github.com/nirholas/three-ui/tree/main/data/skills/development/github-to-mcp-guide
Command: npx skills add https://github.com/nirholas/three-ui --skill github-to-mcp-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of turning a GitHub repository’s API surface into usable Claude Desktop/Cursor/Windsurf/Cline/VS Code tools without manually writing an MCP server from scratch.

Core Features & Use Cases

  • Auto-analyzes repository APIs: Detects OpenAPI/Swagger specs, GraphQL schemas, REST routes, Express/Fastify routing patterns, Next.js route handlers, and function exports.
  • Generates a working MCP server: Produces TypeScript or Python MCP servers with type-safe tool definitions, parameter validation, and error handling.
  • Handles ambiguous APIs with AI assistance: Infers parameter types and tool descriptions when schemas are incomplete or unclear.
  • Use Case: Convert a DeFi protocol like aave-v3-core into MCP tools for supply, borrow, repay, and liquidate; or expose an internal API as AI-accessible tools.

Quick Start

Generate an MCP server by asking your AI to run github-to-mcp for the repository you want to convert and produce output in the mcp-output directory.

Frequently Asked Questions about github-to-mcp-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a GitHub repository API into an MCP server for Claude Desktop or Cursor?▼

To turn a GitHub repository API into an MCP server, use this Skill to auto-analyze the codebase for OpenAPI, GraphQL, and REST endpoints, then generate a type-safe TypeScript or Python server with validated parameters for your AI client.

Can I generate MCP tools from a repository with incomplete OpenAPI or GraphQL schemas?▼

Yes, you can generate MCP tools from incomplete schemas because the Skill uses AI assistance to infer parameter types and generate tool descriptions when the repository's API surface is ambiguous or missing definitions.

What is the best way to expose internal REST routes and Next.js handlers as AI-accessible tools?▼

The best way to expose internal REST routes and Next.js handlers as AI-accessible tools is to extract them directly from the codebase and generate an MCP server with type-safe definitions and error handling.

Does generating an MCP server from a codebase support both TypeScript and Python?▼

Yes, generating an MCP server from a codebase supports both TypeScript and Python, producing type-safe tool definitions with parameter validation and error handling for the detected API surface.

How do I convert a DeFi protocol repository like aave-v3-core into usable MCP tools?▼

You can convert a DeFi protocol repository like aave-v3-core by running this Skill to extract function exports and API routes, generating an MCP server that allows AI clients to reliably call supply, borrow, and liquidate actions.

What are the limitations when extracting API surfaces to create an MCP server?▼

Limitations when extracting API surfaces depend on the repository's structure; if schemas are entirely missing or function exports are deeply ambiguous, the AI must infer types, which may require manual verification to ensure reliable tool generation.

Related Skills

Explore More Software Engineering Skills→
yaklangyaklang
1.6k

api-recon-and-docs

Enumerate API endpoints, schemas, versions, and hidden documentation from OpenAPI/Swagger artifacts.

Official
Intermediate
NotysotyNotysoty
9

MCP Integration Assistant

Design and implement TypeScript MCP servers using @modelcontextprotocol/sdk with Zod validation.

Community
Advanced
mgd34msumgd34msu
4

openapi

Generate TypeScript types and client SDKs from OpenAPI 3.1 specifications.

Community
Advanced
Tonybleything76Tonybleything76

MCP Server Builder

Generate MCP server scaffolds and validate tool definitions from OpenAPI specifications.

Community
Advanced