ultimate-mcp-codegen

Ultimate MCP Code Generator

A token-efficient MCP (Model Context Protocol) server that generates TypeScript code from compact JSON schemas. Reduces AI token usage by 60-70% compared to traditional code generation.

Features

• 🚀 Token Efficient: Compact JSON input instead of full TypeScript code
• 📦 4 Tools: generate_typescript, generate_file, generate_project, generate_statements
• 🔧 Full TypeScript Support: Interfaces, functions, classes, enums, types, constants
• � Control Flow: if/else, for, while, try/catch, switch with nested blocks
• �💾 File System Integration: Optionally write directly to files
• ✅ Validation: Zod-powered input validation

Installation

Option 1: Run directly with npx (Recommended)

npx ultimate-mcp-codegen

Option 2: Install globally

npm install -g ultimate-mcp-codegen
ultimate-mcp-codegen

Option 3: Clone and build locally

git clone https://github.com/MythEclipse/Ultimate-MCP.git
cd Ultimate-MCP
npm install
npm run build

Usage

Start the MCP Server

npm start

Configure with Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

Recommended: Use npx (no install needed)

{
  "mcpServers": {
    "codegen": {
      "command": "npx",
      "args": ["ultimate-mcp-codegen"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "codegen": {
      "command": "ultimate-mcp-codegen"
    }
  }
}

Tools

generate_typescript

Generate TypeScript code snippets from compact JSON.

{
  "code": [
    {
      "type": "interface",
      "name": "User",
      "props": ["id:string", "name:string"]
    }
  ]
}

generate_file

Generate complete files with imports.

{
  "path": "src/types.ts",
  "imports": ["zod:z"],
  "code": [...]
}

generate_project

Batch generate multiple files.

{
  "files": [
    {"path": "src/types.ts", "imports": [], "code": [...]},
    {"path": "src/utils.ts", "imports": [], "code": [...]}
  ]
}

Compact Format

Element	Format	Example
Property	name:type or name?:type	"id:string", "email?:string"
Parameter	name:type or name:type=default	"limit:number=10"
Import	module:items or module	"zod:z,ZodSchema", "express"

License

MIT