github-to-mcp-monorepo 1.0.0

package/apps/web/tailwind.config.ts

@@ -0,0 +1,123 @@
+import type { Config } from 'tailwindcss';
+
+const config: Config = {
+  darkMode: 'class',
+  content: [
+    './pages/**/*.{js,ts,jsx,tsx,mdx}',
+    './components/**/*.{js,ts,jsx,tsx,mdx}',
+    './app/**/*.{js,ts,jsx,tsx,mdx}',
+  ],
+  theme: {
+    extend: {
+      colors: {
+        border: 'hsl(var(--border))',
+        input: 'hsl(var(--input))',
+        ring: 'hsl(var(--ring))',
+        background: 'hsl(var(--background))',
+        foreground: 'hsl(var(--foreground))',
+        primary: {
+          DEFAULT: 'hsl(var(--primary))',
+          foreground: 'hsl(var(--primary-foreground))',
+        },
+        secondary: {
+          DEFAULT: 'hsl(var(--secondary))',
+          foreground: 'hsl(var(--secondary-foreground))',
+        },
+        destructive: {
+          DEFAULT: 'hsl(var(--destructive))',
+          foreground: 'hsl(var(--destructive-foreground))',
+        },
+        muted: {
+          DEFAULT: 'hsl(var(--muted))',
+          foreground: 'hsl(var(--muted-foreground))',
+        },
+        accent: {
+          DEFAULT: 'hsl(var(--accent))',
+          foreground: 'hsl(var(--accent-foreground))',
+        },
+        popover: {
+          DEFAULT: 'hsl(var(--popover))',
+          foreground: 'hsl(var(--popover-foreground))',
+        },
+        card: {
+          DEFAULT: 'hsl(var(--card))',
+          foreground: 'hsl(var(--card-foreground))',
+        },
+        dark: {
+          900: '#000000',
+          800: '#0a0a0a',
+          700: '#171717',
+          600: '#262626',
+        },
+      },
+      borderRadius: {
+        lg: 'var(--radius)',
+        md: 'calc(var(--radius) - 2px)',
+        sm: 'calc(var(--radius) - 4px)',
+      },
+      fontFamily: {
+        sans: ['Inter', 'var(--font-geist-sans)', 'system-ui', '-apple-system', 'sans-serif'],
+        mono: ['JetBrains Mono', 'var(--font-geist-mono)', 'Menlo', 'monospace'],
+      },
+      fontSize: {
+        '2xs': ['0.625rem', { lineHeight: '1rem' }],
+      },
+      animation: {
+        'fade-in': 'fadeIn 0.3s ease-out',
+        'slide-up': 'slideUp 0.3s ease-out',
+        'slide-down': 'slideDown 0.2s ease-out',
+        'slide-in-from-right': 'slideInFromRight 0.2s ease-out',
+        'pulse-slow': 'pulse 3s cubic-bezier(0.4, 0, 0.6, 1) infinite',
+        shimmer: 'shimmer 2s infinite linear',
+        'glow': 'glow 2s ease-in-out infinite alternate',
+        'float': 'float 6s ease-in-out infinite',
+        'gradient': 'gradient 8s ease infinite',
+      },
+      keyframes: {
+        fadeIn: {
+          '0%': { opacity: '0' },
+          '100%': { opacity: '1' },
+        },
+        slideUp: {
+          '0%': { opacity: '0', transform: 'translateY(8px)' },
+          '100%': { opacity: '1', transform: 'translateY(0)' },
+        },
+        slideDown: {
+          '0%': { opacity: '0', transform: 'translateY(-8px)' },
+          '100%': { opacity: '1', transform: 'translateY(0)' },
+        },
+        slideInFromRight: {
+          '0%': { transform: 'translateX(100%)' },
+          '100%': { transform: 'translateX(0)' },
+        },
+        shimmer: {
+          '0%': { backgroundPosition: '-200% 0' },
+          '100%': { backgroundPosition: '200% 0' },
+        },
+        glow: {
+          '0%': { boxShadow: '0 0 5px #00ff88, 0 0 10px #00ff88, 0 0 15px #00ff88' },
+          '100%': { boxShadow: '0 0 10px #00d4ff, 0 0 20px #00d4ff, 0 0 30px #00d4ff' },
+        },
+        float: {
+          '0%, 100%': { transform: 'translateY(0px)' },
+          '50%': { transform: 'translateY(-20px)' },
+        },
+        gradient: {
+          '0%, 100%': { backgroundPosition: '0% 50%' },
+          '50%': { backgroundPosition: '100% 50%' },
+        },
+      },
+      boxShadow: {
+        'glow': '0 0 40px -10px hsl(var(--primary) / 0.3)',
+        'glow-sm': '0 0 20px -5px hsl(var(--primary) / 0.2)',
+      },
+    },
+  },
+  plugins: [
+    require('@tailwindcss/forms'),
+    require('@tailwindcss/typography'),
+    require('tailwindcss-animate'),
+  ],
+};
+
+export default config;

package/apps/web/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "noEmit": true,
+    "incremental": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "plugins": [{ "name": "next" }],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/apps/web/types/deploy.ts

@@ -0,0 +1,139 @@
+/**
+ * Deploy Types - Cloud-hosted MCP Server infrastructure
+ * @copyright 2024-2026 nirholas
+ * @license MIT
+ */
+
+export interface DeployedServer {
+  id: string;
+  name: string;
+  description: string;
+  
+  // Server configuration
+  tools: DeployedTool[];
+  code: string;
+  language: 'typescript' | 'python';
+  
+  // Deployment info
+  endpoint: string;
+  status: 'active' | 'paused' | 'error';
+  region: string;
+  createdAt: string;
+  updatedAt: string;
+  
+  // Source info
+  sourceRepo?: string;
+  sourceUrl?: string;
+  
+  // Auth & Security
+  apiKeyHash?: string;
+  allowedOrigins?: string[];
+  rateLimit: RateLimitConfig;
+  
+  // Usage tracking
+  usage: UsageStats;
+}
+
+export interface DeployedTool {
+  name: string;
+  description: string;
+  inputSchema: object;
+  enabled: boolean;
+  callCount: number;
+  lastUsed?: string;
+  avgLatencyMs?: number;
+}
+
+export interface RateLimitConfig {
+  requestsPerMinute: number;
+  requestsPerDay: number;
+  enabled: boolean;
+}
+
+export interface UsageStats {
+  totalCalls: number;
+  totalCallsToday: number;
+  totalCallsThisMonth: number;
+  successRate: number;
+  avgLatencyMs: number;
+  lastUsed?: string;
+  callsByTool: Record<string, number>;
+  callsByDay: DailyUsage[];
+  errors: ErrorLog[];
+}
+
+export interface DailyUsage {
+  date: string;
+  calls: number;
+  errors: number;
+  avgLatencyMs: number;
+}
+
+export interface ErrorLog {
+  timestamp: string;
+  tool: string;
+  error: string;
+  input?: object;
+}
+
+export interface DeployRequest {
+  name: string;
+  description?: string;
+  code: string;
+  tools: Array<{
+    name: string;
+    description: string;
+    inputSchema: object;
+  }>;
+  sourceRepo?: string;
+  envVars?: Record<string, string>;
+  rateLimit?: Partial<RateLimitConfig>;
+}
+
+export interface DeployResponse {
+  success: boolean;
+  server?: DeployedServer;
+  error?: string;
+  endpoint?: string;
+  apiKey?: string; // Only returned on creation
+}
+
+export interface ServerListResponse {
+  servers: DeployedServer[];
+  total: number;
+  hasMore: boolean;
+}
+
+// MCP Protocol Types for HTTP/SSE transport
+export interface McpRequest {
+  jsonrpc: '2.0';
+  id: string | number;
+  method: string;
+  params?: object;
+}
+
+export interface McpResponse {
+  jsonrpc: '2.0';
+  id: string | number;
+  result?: object;
+  error?: {
+    code: number;
+    message: string;
+    data?: object;
+  };
+}
+
+export interface McpToolCallRequest {
+  name: string;
+  arguments: Record<string, unknown>;
+}
+
+export interface McpToolCallResponse {
+  content: Array<{
+    type: 'text' | 'image' | 'resource';
+    text?: string;
+    data?: string;
+    mimeType?: string;
+  }>;
+  isError?: boolean;
+}

package/apps/web/types/index.ts

@@ -0,0 +1,247 @@
+/**
+ * GitHub to MCP Converter - Type Definitions
+ * @copyright 2024-2026 nirholas
+ * @license MIT
+ */
+
+export interface Tool {
+  name: string;
+  description: string;
+  inputSchema: {
+    type: string;
+    properties?: Record<string, {
+      type: string;
+      description?: string;
+      enum?: string[];
+      default?: unknown;
+    }>;
+    required?: string[];
+  };
+  source: {
+    type: SourceType;
+    file: string;
+    line?: number;
+  };
+}
+
+export type SourceType = 
+  | 'readme'
+  | 'code'
+  | 'openapi'
+  | 'graphql'
+  | 'mcp-introspect'
+  | 'universal'
+  | 'mcp-decorator'
+  | 'python-mcp';
+
+export type RepoClassificationType =
+  | 'mcp-server'
+  | 'api-sdk'
+  | 'cli-tool'
+  | 'library'
+  | 'documentation'
+  | 'data'
+  | 'unknown';
+
+export interface RepoClassification {
+  type: RepoClassificationType;
+  confidence: number;
+  indicators: string[];
+  metadata?: {
+    language?: string;
+    framework?: string;
+    hasOpenAPI?: boolean;
+    hasMcpManifest?: boolean;
+  };
+}
+
+export interface ConversionResult {
+  name: string;
+  description: string;
+  version: string;
+  tools: Tool[];
+  sources: SourceBreakdown[];
+  classification: RepoClassification;
+  code: string;
+  pythonCode?: string;
+  claudeConfig: string;
+  cursorConfig: string;
+  claudePythonConfig?: string;
+  openaiConfig?: string;
+  stats: ConversionStats;
+  repository: RepositoryInfo;
+  generatedAt: string;
+}
+
+export interface SourceBreakdown {
+  type: SourceType;
+  count: number;
+  files: string[];
+}
+
+export interface ConversionStats {
+  totalTools: number;
+  filesAnalyzed: number;
+  processingTimeMs: number;
+  cacheHit: boolean;
+}
+
+export interface RepositoryInfo {
+  owner: string;
+  name: string;
+  fullName: string;
+  url: string;
+  description?: string;
+  stars?: number;
+  language?: string;
+  topics?: string[];
+  lastUpdated?: string;
+}
+
+export interface ConversionRequest {
+  url: string;
+  options?: ConversionOptions;
+}
+
+export interface ConversionOptions {
+  includeUniversalTools?: boolean;
+  maxTools?: number;
+  targetPlatform?: 'claude' | 'cursor' | 'openai' | 'all';
+  customName?: string;
+}
+
+export interface ConversionHistory {
+  id: string;
+  url: string;
+  name: string;
+  toolCount: number;
+  classification: RepoClassificationType;
+  convertedAt: string;
+  result?: ConversionResult;
+}
+
+export interface ApiError {
+  error: string;
+  code: string;
+  details?: string;
+  retryAfter?: number;
+}
+
+export type ConversionStatus = 'idle' | 'loading' | 'success' | 'error';
+
+// ===== Streaming Types =====
+export interface StreamingEvent {
+  type: 'progress' | 'tool' | 'complete' | 'error';
+  data: StreamingProgressData | StreamingToolData | StreamingCompleteData | StreamingErrorData;
+  timestamp: string;
+}
+
+export interface StreamingProgressData {
+  step: string;
+  description: string;
+  progress: number; // 0-100
+  details?: string;
+}
+
+export interface StreamingToolData {
+  tool: Tool;
+  index: number;
+  total: number;
+}
+
+export interface StreamingCompleteData {
+  result: ConversionResult;
+  totalTime: number;
+}
+
+export interface StreamingErrorData {
+  error: string;
+  code: string;
+  details?: string;
+}
+
+export type StreamingStatus = 'idle' | 'connecting' | 'streaming' | 'complete' | 'error';
+
+// ===== Docker Types =====
+export interface DockerConfig {
+  dockerfile: string;
+  dockerCompose: string;
+  envExample: string;
+  buildCommand: string;
+  runCommand: string;
+  serverName: string;
+}
+
+export interface DockerExportOptions {
+  baseImage: string;
+  port: number;
+  exposePorts: number[];
+  envVars: Record<string, string>;
+  volumes: string[];
+  healthCheck: boolean;
+  multiStage: boolean;
+  runAsNonRoot: boolean;
+  labels: boolean;
+}
+
+// ===== Batch Conversion Types =====
+export interface BatchConversionItem {
+  id: string;
+  url: string;
+  status: 'pending' | 'converting' | 'success' | 'error';
+  result?: ConversionResult;
+  error?: ApiError;
+  progress?: number;
+  startedAt?: string;
+  completedAt?: string;
+}
+
+export type BatchConversionState = 'idle' | 'running' | 'paused' | 'complete';
+
+export interface BatchConversionStats {
+  items: BatchConversionItem[];
+  status: BatchConversionState;
+  totalCount: number;
+  completedCount: number;
+  errorCount: number;
+  startedAt?: string;
+  completedAt?: string;
+}
+
+// ===== One-Click Install Types =====
+export type InstallPlatform = 'macos' | 'windows' | 'linux' | 'docker';
+
+export interface InstallInstructions {
+  platform: InstallPlatform;
+  title: string;
+  description: string;
+  prerequisites: string[];
+  steps: InstallStep[];
+  estimatedTime: string;
+  requirements?: string[];
+  notes?: string[];
+}
+
+export interface InstallStep {
+  title: string;
+  description: string;
+  command: string;
+  isOptional: boolean;
+  warning?: string;
+  note?: string;
+  link?: string;
+  code?: string;
+  language?: string;
+  isManual?: boolean;
+}
+
+export interface PlatformDetection {
+  os: InstallPlatform;
+  arch: 'x64' | 'arm64';
+  nodeVersion?: string;
+  npmVersion?: string;
+  hasDocker?: boolean;
+  hasPython?: boolean;
+  pythonVersion?: string;
+}
+

package/apps/web/vercel.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://openapi.vercel.sh/vercel.json",
+  "buildCommand": "cd ../.. && pip install -q -r mkdocs/python-deps.txt && cd mkdocs && python -m mkdocs build --site-dir ../apps/web/public/docs && cd ../apps/web && pnpm run build:packages && pnpm build",
+  "installCommand": "cd ../.. && pnpm install",
+  "framework": "nextjs",
+  "outputDirectory": ".next",
+  "headers": [
+    {
+      "source": "/docs/:path*",
+      "headers": [
+        {
+          "key": "Cache-Control",
+          "value": "public, max-age=3600, stale-while-revalidate=86400"
+        }
+      ]
+    },
+    {
+      "source": "/api/edge",
+      "headers": [
+        {
+          "key": "Cache-Control",
+          "value": "public, s-maxage=60, stale-while-revalidate=300"
+        },
+        {
+          "key": "Access-Control-Allow-Origin",
+          "value": "*"
+        },
+        {
+          "key": "Access-Control-Allow-Methods",
+          "value": "GET, POST, OPTIONS"
+        },
+        {
+          "key": "Access-Control-Allow-Headers",
+          "value": "Content-Type, Authorization"
+        }
+      ]
+    }
+  ]
+}

package/eslint.config.mjs

@@ -0,0 +1,23 @@
+import js from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    ignores: [
+      '**/dist/**',
+      '**/node_modules/**',
+      '**/.next/**',
+      '**/coverage/**',
+      '_archive/**',
+    ],
+  },
+  {
+    rules: {
+      '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/no-require-imports': 'off',
+    },
+  }
+);

package/llms.txt

@@ -0,0 +1,102 @@
+# GitHub to MCP
+
+> Convert any GitHub repository into an MCP server for AI assistants
+
+## Summary
+
+GitHub to MCP is a tool that automatically generates Model Context Protocol (MCP) servers from GitHub repositories. It enables AI assistants like Claude, ChatGPT, Cursor, and Cline to interact with any codebase through standardized tools.
+
+## What This Project Does
+
+- Takes a GitHub repository URL as input
+- Analyzes the repository structure and content
+- Extracts tools from OpenAPI specs, GraphQL schemas, Python decorators, and documentation
+- Generates a complete MCP server (TypeScript or Python) with all dependencies
+- Provides universal tools: read_file, list_files, search_code, get_readme
+
+## Key Concepts
+
+**MCP (Model Context Protocol)**: An open standard by Anthropic that allows AI models to securely connect to external tools and data sources.
+
+**MCP Server**: A program that exposes tools to AI assistants. Tools are functions the AI can call to read files, query APIs, execute commands, etc.
+
+**Tool Extraction**: The process of analyzing code and documentation to automatically identify functions that should become MCP tools.
+
+## Usage
+
+### Web UI
+Visit https://github-to-mcp.vercel.app and paste any GitHub URL.
+
+### CLI
+```bash
+npx @nirholas/github-to-mcp https://github.com/owner/repo
+```
+
+### Programmatic
+```typescript
+import { generateFromGithub } from '@nirholas/github-to-mcp';
+const result = await generateFromGithub('https://github.com/owner/repo');
+await result.save('./output');
+```
+
+## Project Structure
+
+- `packages/core/` - Main conversion engine (npm: @nirholas/github-to-mcp)
+- `packages/openapi-parser/` - OpenAPI and GraphQL parsing
+- `apps/web/` - Next.js web interface
+- `apps/docs/` - Documentation site
+
+## Key Files
+
+- `packages/core/src/index.ts` - Main API exports
+- `packages/core/src/github-client.ts` - GitHub API interaction
+- `packages/core/src/code-extractor.ts` - Extract tools from Python/TypeScript code
+- `packages/core/src/readme-extractor.ts` - Extract tools from documentation
+- `packages/openapi-parser/src/parser.ts` - OpenAPI spec parsing
+
+## Supported Extraction Sources
+
+1. **OpenAPI/Swagger specs** - REST API endpoints become tools
+2. **GraphQL schemas** - Queries and mutations become tools
+3. **Python code** - Functions with `@mcp.tool` decorators
+4. **TypeScript code** - `server.tool()` registrations
+5. **README documentation** - Command and function patterns
+
+## API Reference
+
+### generateFromGithub(url: string, options?: Options)
+
+Main function to convert a repository.
+
+**Parameters:**
+- `url` - GitHub repository URL
+- `options.token` - GitHub token for private repos
+- `options.outputFormat` - 'typescript' or 'python'
+
+**Returns:**
+- `tools` - Array of extracted tools
+- `classification` - Detected repo type
+- `save(path)` - Save generated server to disk
+- `generate()` - Get generated code as string
+
+## Common Tasks
+
+### Give an AI access to a codebase
+1. Run: `npx @nirholas/github-to-mcp https://github.com/owner/repo`
+2. Add the generated server to Claude Desktop config
+3. The AI can now read files and search code
+
+### Convert a REST API to MCP tools
+1. Find a repo with an OpenAPI/Swagger spec
+2. Run the converter - API endpoints become callable tools
+3. AI assistants can now query the API
+
+### Access private repositories
+Set GITHUB_TOKEN environment variable with a token that has repo access.
+
+## Links
+
+- Website: https://github-to-mcp.vercel.app
+- npm: https://www.npmjs.com/package/@nirholas/github-to-mcp
+- GitHub: https://github.com/nirholas/github-to-mcp
+- MCP Protocol: https://modelcontextprotocol.io