github-to-mcp-monorepo 1.0.0

package/mkdocs/mkdocs.yml

@@ -0,0 +1,204 @@
+# Project information
+site_name: GitHub to MCP
+site_url: https://docs-github-to-mcp.vercel.app/
+site_author: nirholas
+site_description: >-
+  Convert any GitHub repository into an MCP server in seconds.
+  Give Claude, ChatGPT, Cursor, and any AI assistant instant access to any codebase.
+
+# Use /docs as base path since it's served from Next.js
+use_directory_urls: true
+
+# Repository
+repo_name: nirholas/github-to-mcp
+repo_url: https://github.com/nirholas/github-to-mcp
+edit_uri: edit/main/mkdocs/docs/
+
+# Copyright
+copyright: Copyright © 2024-2026 nirholas
+
+# Configuration
+theme:
+  name: material
+  custom_dir: overrides
+  favicon: assets/logo.svg
+  logo: assets/logo.svg
+  
+  palette:
+    # Light mode
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      primary: black
+      accent: grey
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    
+    # Dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: black
+      accent: grey
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+
+  font:
+    text: Inter
+    code: JetBrains Mono
+
+  features:
+    - announce.dismiss
+    - content.action.edit
+    - content.action.view
+    - content.code.annotate
+    - content.code.copy
+    - content.tabs.link
+    - content.tooltips
+    - header.autohide
+    - navigation.expand
+    - navigation.footer
+    - navigation.indexes
+    - navigation.instant
+    - navigation.instant.prefetch
+    - navigation.instant.progress
+    - navigation.prune
+    - navigation.sections
+    - navigation.tabs
+    - navigation.tabs.sticky
+    - navigation.top
+    - navigation.tracking
+    - search.highlight
+    - search.share
+    - search.suggest
+    - toc.follow
+
+  icon:
+    repo: fontawesome/brands/github
+
+# Plugins
+plugins:
+  - search:
+      separator: '[\s\u200b\-_,:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;|(?!\b)(?=[A-Z][a-z])'
+  - minify:
+      minify_html: true
+
+# Extensions
+markdown_extensions:
+  - abbr
+  - admonition
+  - attr_list
+  - def_list
+  - footnotes
+  - md_in_html
+  - toc:
+      permalink: true
+      title: On this page
+  - tables
+  - pymdownx.arithmatex:
+      generic: true
+  - pymdownx.betterem:
+      smart_enable: all
+  - pymdownx.caret
+  - pymdownx.details
+  - pymdownx.emoji:
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite
+  - pymdownx.keys
+  - pymdownx.magiclink:
+      normalize_issue_symbols: true
+      repo_url_shorthand: true
+      user: nirholas
+      repo: github-to-mcp
+  - pymdownx.mark
+  - pymdownx.smartsymbols
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:pymdownx.superfences.fence_code_format
+  - pymdownx.tabbed:
+      alternate_style: true
+      combine_header_slug: true
+  - pymdownx.tasklist:
+      custom_checkbox: true
+  - pymdownx.tilde
+
+# Extra configuration
+extra:
+  social:
+    - icon: fontawesome/brands/github
+      link: https://github.com/nirholas/github-to-mcp
+      name: GitHub
+    - icon: fontawesome/brands/npm
+      link: https://www.npmjs.com/package/@nirholas/github-to-mcp
+      name: npm
+    - icon: fontawesome/brands/twitter
+      link: https://twitter.com/nirholas
+      name: Twitter
+  
+  generator: false
+  
+  analytics:
+    provider: google
+    property: !ENV GOOGLE_ANALYTICS_KEY
+
+extra_css:
+  - stylesheets/extra.css
+
+# Page tree
+nav:
+  - Home: index.md
+  
+  - Getting Started:
+    - getting-started/index.md
+    - Installation: getting-started/installation.md
+    - Quick Start: getting-started/quickstart.md
+    - Configuration: getting-started/configuration.md
+  
+  - Guides:
+    - guides/index.md
+    - Claude Desktop: guides/claude-desktop.md
+    - Cursor Integration: guides/cursor.md
+    - VS Code: guides/vscode.md
+    - Private Repos: guides/private-repos.md
+    - Custom Tools: guides/custom-tools.md
+    - Batch Conversion: guides/batch.md
+  
+  - CLI:
+    - cli/index.md
+    - generate: cli/generate.md
+    - inspect: cli/inspect.md
+    - serve: cli/serve.md
+  
+  - API:
+    - api/index.md
+    - Core: api/core.md
+    - OpenAPI Parser: api/openapi-parser.md
+    - MCP Server: api/mcp-server.md
+  
+  - Concepts:
+    - concepts/index.md
+    - How It Works: concepts/how-it-works.md
+    - Tool Types: concepts/tool-types.md
+    - Repository Classification: concepts/classification.md
+    - MCP Protocol: concepts/mcp-protocol.md
+  
+  - Reference:
+    - reference/index.md
+    - Generated Tools: reference/tools.md
+    - Configuration Options: reference/config.md
+    - Environment Variables: reference/env.md
+  
+  - Contributing:
+    - contributing/index.md
+    - Development Setup: contributing/development.md
+    - Architecture: contributing/architecture.md
+    - Testing: contributing/testing.md
+  
+  - Changelog: changelog.md

package/mkdocs/overrides/.gitkeep

@@ -0,0 +1 @@
+<!-- Empty file to enable custom overrides directory -->

package/mkdocs/overrides/main.html

@@ -0,0 +1,7 @@
+{% extends "base.html" %}
+
+{% block announce %}
+<a href="https://github.com/nirholas/github-to-mcp">
+  ⭐ Star us on GitHub!
+</a>
+{% endblock %}

package/mkdocs/python-deps.txt

@@ -0,0 +1,7 @@
+# MkDocs Documentation Dependencies
+# Install with: pip install -r requirements.txt
+
+mkdocs>=1.6.0,<2.0
+mkdocs-material>=9.5.0,<10.0
+mkdocs-minify-plugin>=0.7.0,<1.0
+pymdown-extensions>=10.0,<11.0

package/mkdocs/vercel.json

@@ -0,0 +1,11 @@
+{
+  "build": {
+    "env": {
+      "PYTHON_VERSION": "3.12"
+    }
+  },
+  "buildCommand": "pip install -r requirements.txt && mkdocs build",
+  "outputDirectory": "site",
+  "installCommand": "pip install -r requirements.txt",
+  "framework": null
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "github-to-mcp-monorepo",
+  "version": "1.0.0",
+  "private": false,
+  "description": "Convert any GitHub repository into an MCP server",
+  "packageManager": "pnpm@10.23.0",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "dev": "pnpm --filter web dev",
+    "build": "pnpm -r build",
+    "build:core": "pnpm --filter @nirholas/github-to-mcp build",
+    "build:web": "pnpm --filter web build",
+    "lint": "pnpm -r lint",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:ui": "vitest --ui",
+    "test:e2e": "pnpm --filter web test:e2e",
+    "typecheck": "pnpm -r typecheck",
+    "prepare": "husky",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release": "pnpm build && changeset publish"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "github",
+    "ai",
+    "tools"
+  ],
+  "author": "nirholas",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nirholas/github-to-mcp"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.8",
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^25.0.6",
+    "@typescript-eslint/eslint-plugin": "^8.53.0",
+    "@typescript-eslint/parser": "^8.53.0",
+    "@vitest/coverage-v8": "^4.0.16",
+    "eslint": "^9.39.2",
+    "happy-dom": "^20.1.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "msw": "^2.12.7",
+    "prettier": "^3.8.0",
+    "vitest": "^1.6.1"
+  },
+  "lint-staged": {
+    "*.{ts,tsx}": [
+      "eslint --fix"
+    ],
+    "*.{json,md,yaml,yml}": [
+      "prettier --write"
+    ]
+  }
+}

package/packages/core/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@nirholas/github-to-mcp",
+  "version": "1.0.0",
+  "description": "Convert GitHub repositories into MCP servers",
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "bin": {
+    "github-to-mcp": "./dist/cli.mjs"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "github",
+    "ai",
+    "tools",
+    "openapi"
+  ],
+  "author": "nirholas",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nirholas/github-to-mcp"
+  },
+  "dependencies": {
+    "@github-to-mcp/openapi-parser": "workspace:*",
+    "@octokit/rest": "^21.0.0",
+    "commander": "^12.0.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.0",
+    "marked": "^12.0.0",
+    "prompts": "^2.4.2",
+    "chokidar": "^3.6.0",
+    "cli-table3": "^0.6.3",
+    "yaml": "^2.8.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "@types/node": "^20.0.0",
+    "@types/prompts": "^2.4.9"
+  }
+}