github-to-mcp-monorepo 1.0.0

package/packages/registry/src/updater.ts

@@ -0,0 +1,208 @@
+/**
+ * @fileoverview Registry updater for checking and updating entries
+ * @copyright Copyright (c) 2024-2026 nirholas
+ * @license Apache-2.0
+ */
+
+import type {
+  RegistryEntry,
+  UpdateInfo,
+  StorageAdapter,
+} from './types';
+
+/**
+ * Options for the updater
+ */
+export interface UpdaterOptions {
+  /** GitHub token for API requests */
+  githubToken?: string;
+  /** Whether to auto-update entries */
+  autoUpdate?: boolean;
+  /** Check interval in milliseconds */
+  checkInterval?: number;
+}
+
+/**
+ * Registry updater - checks for updates from source repos
+ */
+export class RegistryUpdater {
+  private storage: StorageAdapter;
+  private options: UpdaterOptions;
+
+  constructor(storage: StorageAdapter, options: UpdaterOptions = {}) {
+    this.storage = storage;
+    this.options = options;
+  }
+
+  /**
+   * Check if an entry has updates available
+   */
+  async checkForUpdates(id: string): Promise<UpdateInfo | null> {
+    const entry = await this.storage.get(id);
+    if (!entry) return null;
+
+    try {
+      const latestVersion = await this.getLatestSourceVersion(entry.sourceRepo);
+      
+      if (latestVersion && latestVersion !== entry.sourceVersion) {
+        return {
+          id: entry.id,
+          currentVersion: entry.version,
+          latestVersion: this.incrementVersion(entry.version),
+          changelog: `Updated from ${entry.sourceVersion} to ${latestVersion}`,
+          breaking: this.isBreakingUpdate(entry.sourceVersion, latestVersion),
+        };
+      }
+      
+      return null;
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * Check all entries for updates
+   */
+  async checkAllForUpdates(): Promise<UpdateInfo[]> {
+    const updates: UpdateInfo[] = [];
+    const result = await this.storage.list({ limit: 1000 });
+    
+    for (const summary of result.entries) {
+      const update = await this.checkForUpdates(summary.id);
+      if (update) {
+        updates.push(update);
+      }
+    }
+    
+    return updates;
+  }
+
+  /**
+   * Get the latest version/commit from source repo
+   */
+  private async getLatestSourceVersion(sourceRepo: string): Promise<string | null> {
+    const [owner, repo] = sourceRepo.split('/');
+    if (!owner || !repo) return null;
+
+    const headers: Record<string, string> = {
+      'Accept': 'application/vnd.github.v3+json',
+      'User-Agent': 'github-to-mcp-registry',
+    };
+
+    if (this.options.githubToken) {
+      headers['Authorization'] = `Bearer ${this.options.githubToken}`;
+    }
+
+    try {
+      // Try to get latest release first
+      const releaseResponse = await fetch(
+        `https://api.github.com/repos/${owner}/${repo}/releases/latest`,
+        { headers }
+      );
+      
+      if (releaseResponse.ok) {
+        const release = await releaseResponse.json() as { tag_name: string };
+        return release.tag_name;
+      }
+
+      // Fall back to latest commit on default branch
+      const commitResponse = await fetch(
+        `https://api.github.com/repos/${owner}/${repo}/commits?per_page=1`,
+        { headers }
+      );
+      
+      if (commitResponse.ok) {
+        const commits = await commitResponse.json() as Array<{ sha: string }>;
+        if (commits.length > 0) {
+          return commits[0].sha.substring(0, 7);
+        }
+      }
+
+      return null;
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * Increment a semver version
+   */
+  private incrementVersion(version: string): string {
+    const parts = version.split('.');
+    if (parts.length === 3) {
+      const patch = parseInt(parts[2], 10) || 0;
+      return `${parts[0]}.${parts[1]}.${patch + 1}`;
+    }
+    return `${version}.1`;
+  }
+
+  /**
+   * Check if an update is a breaking change
+   * (Simple heuristic based on major version)
+   */
+  private isBreakingUpdate(oldVersion: string, newVersion: string): boolean {
+    const oldMajor = this.extractMajorVersion(oldVersion);
+    const newMajor = this.extractMajorVersion(newVersion);
+    return newMajor > oldMajor;
+  }
+
+  /**
+   * Extract major version number
+   */
+  private extractMajorVersion(version: string): number {
+    const match = version.match(/^v?(\d+)/);
+    return match ? parseInt(match[1], 10) : 0;
+  }
+
+  /**
+   * Update an entry from its source repo
+   * Requires the core generator to be available
+   */
+  async updateEntry(
+    id: string,
+    generator?: { generate: (url: string) => Promise<unknown> }
+  ): Promise<RegistryEntry | null> {
+    const entry = await this.storage.get(id);
+    if (!entry) return null;
+
+    if (!generator) {
+      console.warn('Generator not provided, cannot regenerate entry');
+      return null;
+    }
+
+    try {
+      // Regenerate from source
+      const result = await generator.generate(entry.sourceUrl) as {
+        tools: Array<{ name: string; description: string; source: { type: string }; inputSchema: { properties: object } }>;
+        generate: () => string;
+        generatePython?: () => string;
+      };
+      
+      // Update entry
+      const updatedEntry: RegistryEntry = {
+        ...entry,
+        version: this.incrementVersion(entry.version),
+        sourceVersion: await this.getLatestSourceVersion(entry.sourceRepo) || entry.sourceVersion,
+        toolCount: result.tools.length,
+        tools: result.tools.map(t => ({
+          name: t.name,
+          description: t.description,
+          source: t.source.type,
+          paramCount: Object.keys(t.inputSchema?.properties || {}).length,
+          requiresAuth: entry.auth.length > 0,
+        })),
+        generatedCode: {
+          typescript: result.generate(),
+          python: result.generatePython?.(),
+        },
+        lastUpdated: new Date().toISOString(),
+      };
+
+      await this.storage.save(updatedEntry);
+      return updatedEntry;
+    } catch (error) {
+      console.error(`Failed to update entry ${id}:`, error);
+      return null;
+    }
+  }
+}

package/packages/registry/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/packages/registry/tsup.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  dts: true,
+  sourcemap: true,
+  clean: true,
+  target: 'es2022',
+  outExtension: () => ({ js: '.mjs' }),
+});

package/pnpm-workspace.yaml

@@ -0,0 +1,3 @@
+packages:
+  - "packages/*"
+  - "apps/*"

package/scripts/build-docs.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+# Build MkDocs and copy to Next.js public folder
+
+set -e
+
+echo "Building MkDocs documentation..."
+
+# Install MkDocs dependencies
+pip install -q -r mkdocs/requirements.txt
+
+# Build MkDocs to static HTML
+cd mkdocs
+mkdocs build --site-dir ../apps/web/public/docs
+cd ..
+
+echo "✓ MkDocs built to apps/web/public/docs"

package/server.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.nirholas/github-to-mcp",
+  "version": "1.0.0",
+  "title": "GitHub to MCP Converter",
+  "description": "Convert any GitHub repo to MCP server - automatic tool generation API wrap",
+  "keywords": ["github", "mcp", "converter", "generator", "api", "tools"],
+  "repository": {"url": "https://github.com/nirholas/github-to-mcp", "source": "github"}
+}

package/templates/Dockerfile.python.template

@@ -0,0 +1,60 @@
+# Auto-generated Dockerfile for {{name}} MCP Server (Python)
+# Generated by @nirholas/github-to-mcp
+
+# Build stage
+FROM python:3.11-slim AS builder
+
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install Python dependencies
+COPY requirements.txt ./
+RUN pip install --no-cache-dir --user -r requirements.txt
+
+# Production stage
+FROM python:3.11-slim AS production
+
+WORKDIR /app
+
+# Create non-root user
+RUN useradd -m -u 1001 mcpserver
+
+# Copy Python packages from builder
+COPY --from=builder /root/.local /home/mcpserver/.local
+
+# Copy source code
+COPY . .
+
+# Change ownership
+RUN chown -R mcpserver:mcpserver /app
+
+LABEL org.opencontainers.image.title="{{name}}-mcp-server"
+LABEL org.opencontainers.image.description="{{description}}"
+LABEL org.opencontainers.image.source="https://github.com/{{repo}}"
+LABEL maintainer="Generated by @nirholas/github-to-mcp"
+
+# Set production environment
+ENV PYTHONUNBUFFERED=1
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV PATH=/home/mcpserver/.local/bin:$PATH
+ENV PORT={{port}}
+
+# Expose port
+EXPOSE {{port}}
+
+# Health check
+HEALTHCHECK --interval=30s \
+  --timeout=10s \
+  --start-period=5s \
+  --retries=3 \
+  CMD python -c "import sys; sys.exit(0)"
+
+# Switch to non-root user
+USER mcpserver
+
+# Start the MCP server
+CMD ["python", "-m", "mcp_server"]

package/templates/Dockerfile.typescript.template

@@ -0,0 +1,60 @@
+# Auto-generated Dockerfile for {{name}} MCP Server
+# Generated by @nirholas/github-to-mcp
+
+# Build stage
+FROM node:20-alpine AS builder
+
+WORKDIR /app
+
+# Install dependencies
+COPY package*.json ./
+COPY pnpm-lock.yaml* ./
+
+# Use pnpm if available, fallback to npm
+RUN corepack enable pnpm 2>/dev/null || npm install -g pnpm
+RUN pnpm install --frozen-lockfile || npm ci
+
+# Copy source code
+COPY . .
+
+# Build TypeScript
+RUN pnpm build || npm run build
+
+# Production stage
+FROM node:20-alpine AS production
+
+WORKDIR /app
+
+# Create non-root user
+RUN addgroup -g 1001 -S nodejs && \
+    adduser -S mcpserver -u 1001
+
+# Copy built files and dependencies
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/package.json ./
+
+LABEL org.opencontainers.image.title="{{name}}-mcp-server"
+LABEL org.opencontainers.image.description="{{description}}"
+LABEL org.opencontainers.image.source="https://github.com/{{repo}}"
+LABEL maintainer="Generated by @nirholas/github-to-mcp"
+
+# Set production environment
+ENV NODE_ENV=production
+ENV PORT={{port}}
+
+# Expose port
+EXPOSE {{port}}
+
+# Health check
+HEALTHCHECK --interval=30s \
+  --timeout=10s \
+  --start-period=5s \
+  --retries=3 \
+  CMD node -e "process.exit(0)"
+
+# Switch to non-root user
+USER mcpserver
+
+# Start the MCP server
+CMD ["node", "dist/index.js"]

package/templates/docker-compose.template.yml

@@ -0,0 +1,68 @@
+# Auto-generated Docker Compose for {{name}} MCP Server
+# Generated by @nirholas/github-to-mcp
+
+version: '3.8'
+
+services:
+  {{serviceName}}:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    container_name: {{serviceName}}-mcp
+    restart: unless-stopped
+    ports:
+      - "{{port}}:{{port}}"
+    environment:
+      NODE_ENV: "production"
+      PORT: "{{port}}"
+      {{#if redisEnabled}}
+      REDIS_URL: "redis://redis:6379"
+      {{/if}}
+    {{#if volumes}}
+    volumes:
+      {{#each volumes}}
+      - {{this}}
+      {{/each}}
+    {{/if}}
+    {{#if dependsOn}}
+    depends_on:
+      {{#each dependsOn}}
+      - {{this}}
+      {{/each}}
+    {{/if}}
+    networks:
+      - mcp-network
+    healthcheck:
+      test: ["CMD", "node", "-e", "process.exit(0)"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s
+
+  {{#if redisEnabled}}
+  redis:
+    image: redis:7-alpine
+    container_name: {{serviceName}}-redis
+    restart: unless-stopped
+    ports:
+      - "6379:6379"
+    volumes:
+      - redis-data:/data
+    networks:
+      - mcp-network
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+  {{/if}}
+
+networks:
+  mcp-network:
+    driver: bridge
+
+volumes:
+  {{serviceName}}-data:
+  {{#if redisEnabled}}
+  redis-data:
+  {{/if}}

package/tests/fixtures/express-app/index.js

@@ -0,0 +1,34 @@
+/**
+ * Sample Express.js application for testing
+ */
+const express = require('express');
+const app = express();
+const usersRouter = require('./routes/users');
+const postsRouter = require('./routes/posts');
+
+app.use(express.json());
+
+// API routes
+app.use('/api', usersRouter);
+app.use('/api', postsRouter);
+
+/**
+ * Health check endpoint
+ * @tag System
+ */
+app.get('/health', (req, res) => {
+  res.json({ status: 'ok' });
+});
+
+/**
+ * API info endpoint
+ * @tag System
+ */
+app.get('/api/info', (req, res) => {
+  res.json({
+    name: 'Test API',
+    version: '1.0.0',
+  });
+});
+
+module.exports = app;

package/tests/fixtures/express-app/routes/posts.js

@@ -0,0 +1,43 @@
+/**
+ * Posts routes for testing
+ */
+const express = require('express');
+const router = express.Router();
+
+/**
+ * Get all posts with pagination
+ * @tag Posts
+ * @param {number} req.query.page - Page number
+ * @param {number} req.query.limit - Items per page
+ */
+router.get('/posts', (req, res) => {
+  const { page = 1, limit = 10 } = req.query;
+  res.json({ posts: [], page, limit, total: 0 });
+});
+
+/**
+ * Get post by ID
+ * @tag Posts
+ */
+router.get('/posts/:postId', (req, res) => {
+  res.json({ id: req.params.postId, title: 'Test Post' });
+});
+
+/**
+ * Create post
+ * @tag Posts
+ */
+router.post('/posts', (req, res) => {
+  res.status(201).json({ id: '456', ...req.body });
+});
+
+/**
+ * Get comments for a post
+ * @tag Posts
+ * @tag Comments
+ */
+router.get('/posts/:postId/comments', (req, res) => {
+  res.json({ comments: [] });
+});
+
+module.exports = router;

package/tests/fixtures/express-app/routes/users.js

@@ -0,0 +1,58 @@
+/**
+ * Sample Express.js application for testing
+ */
+const express = require('express');
+const router = express.Router();
+
+/**
+ * Get all users
+ * @tag Users
+ * @returns {array} List of users
+ */
+router.get('/users', (req, res) => {
+  const { limit, offset } = req.query;
+  res.json({ users: [], limit, offset });
+});
+
+/**
+ * Get user by ID
+ * @tag Users
+ * @param {string} req.params.id - User ID
+ * @returns {object} User object
+ */
+router.get('/users/:id', (req, res) => {
+  const { id } = req.params;
+  res.json({ id, name: 'Test User' });
+});
+
+/**
+ * Create a new user
+ * @tag Users
+ * @body {object} User data
+ * @returns {object} Created user
+ */
+router.post('/users', (req, res) => {
+  const userData = req.body;
+  res.status(201).json({ id: '123', ...userData });
+});
+
+/**
+ * Update user
+ * @tag Users
+ * @deprecated
+ */
+router.put('/users/:id', (req, res) => {
+  const { id } = req.params;
+  const userData = req.body;
+  res.json({ id, ...userData });
+});
+
+/**
+ * Delete user
+ * @tag Users
+ */
+router.delete('/users/:id', (req, res) => {
+  res.status(204).send();
+});
+
+module.exports = router;