github-to-mcp-guide

github-to-mcp-guide is a skill for Claude Code, Codex from nirholas/three.ws. It costs 68 tokens per session (830 once invoked), scanned A, original, Apache-2.0.

A tool that examines a GitHub repository and creates an MCP server from its APIs or exported functions. An MCP server exposes these capabilities as tools that AI applications can call.

In plain words
What is it for?
Use it to generate TypeScript or Python MCP servers from GitHub projects, with tool definitions, input checks, and error handling.
Why use it?
It removes much of the manual work needed to connect an existing repository’s REST, GraphQL, OpenAPI, or framework routes to an AI agent.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/nirholas/three.ws/github-to-mcp-guide
Any agent
npx skills add nirholas/three.ws --skill github-to-mcp-guide
Clone the repo
git clone --depth 1 https://github.com/nirholas/three.ws

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for github-to-mcp-guide

README.md
[![agentmods](https://agentmods.dev/badge/skills/nirholas/three.ws/github-to-mcp-guide.svg)](https://agentmods.dev/skills/nirholas/three.ws/github-to-mcp-guide)
Your own site
<a href="https://agentmods.dev/skills/nirholas/three.ws/github-to-mcp-guide"><img src="https://agentmods.dev/badge/skills/nirholas/three.ws/github-to-mcp-guide.svg" alt="Measured on agentmods" height="20"></a>
Per session 68 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 830 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00068 $0.00830
Opus 5 $0.00034 $0.00415
Sonnet 5 $0.00014 $0.00166
Haiku 4.5 $0.00007 $0.00083

Measured yesterday against content hash add2eda174e9, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

github-to-mcp-guide scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

data/skills/development/github-to-mcp-guide/SKILL.md · 114 lines

How it starts

The opening of the file, as written. The whole thing — 114 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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.

Read the full file on GitHub · 114 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 114 lines · 68 tokens per session scan A add2eda174e9

Subscribe to this mod's changes

github-to-mcp-guide is a skill published in the GitHub repository nirholas/three.ws (110 stars, last pushed yesterday), licensed Apache-2.0. It adds 68 tokens to every session and 830 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

blender-mcp

Drive Blender via the catalog blender MCP, with bpy recipes.

GGbond-bo/MemOmics-Agent · 17 tokens

blender-mcp

Control Blender directly from Gauss via socket connection to the blender-mcp addon. Create 3D objects, materials, animations, and run arbitrary Blender Python (bpy) code. Use when user wants to create or modify anything in Blender.

math-inc/OpenGauss · 54 tokens

threejs-docs

Comprehensive Three.js reference covering core API (objects, cameras, lights, materials, geometries, renderers, scenes, textures, math, animation, audio, loaders, helpers, nodes), all addons (controls, postprocessing, loaders, exporters, geometries, shaders, WebXR, physics), TSL (Three.js Shading Language) functions…

pledgeandgrow/pledge-skills · 112 tokens

blender-mcp

Control Blender directly from Hermes via socket connection to the blender-mcp addon. Create 3D objects, materials, animations, and run arbitrary Blender Python (bpy) code. Use when user wants to create or modify anything in Blender.

raphaelmansuy/edgecrab · 53 tokens

blender-mcp

Control Blender directly from Hermes via socket connection to the blender-mcp addon. Create 3D objects, materials, animations, and run arbitrary Blender Python (bpy) code. Use when user wants to create or modify anything in Blender.

johnson7788/MultiUserClaw · 53 tokens

3d-website-architect

Expert skill for designing, building, and deploying modern premium websites with advanced animations and 3D interactive experiences using Three.js, React Three Fiber, GSAP, and Framer Motion. Use this skill whenever the user wants to build a website with 3D elements, create an immersive web experience, add interactive…

deveshpunjabi/3d-website-skill · 240 tokens