Initial commit: Docusaurus MCP server plugin

A Docusaurus plugin that exposes an MCP (Model Context Protocol) server
endpoint for AI agents to search and retrieve documentation.

Features:
- postBuild hook extracts content from rendered HTML
- FlexSearch-powered full-text search with relevance ranking
- MCP tools: docs_search, docs_get_page, docs_get_section
- Platform adapters for Vercel, Netlify, and Cloudflare Workers
- McpInstallButton React component for easy client setup

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: steve-calvert-glean

.eslintrc.cjs

@@ -0,0 +1,70 @@
+/** @type {import('eslint').Linter.Config} */
+module.exports = {
+  root: true,
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    ecmaVersion: 2022,
+    sourceType: 'module',
+    project: './tsconfig.json',
+  },
+  env: {
+    browser: true,
+    es2021: true,
+    node: true,
+  },
+  plugins: ['@typescript-eslint', 'import'],
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:import/recommended',
+    'plugin:import/typescript',
+  ],
+  settings: {
+    'import/resolver': {
+      typescript: {
+        project: './tsconfig.json',
+      },
+      node: true,
+    },
+  },
+  rules: {
+    // TypeScript specific
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
+    '@typescript-eslint/no-explicit-any': 'warn',
+    '@typescript-eslint/no-unused-vars': [
+      'error',
+      {
+        argsIgnorePattern: '^_',
+        varsIgnorePattern: '^_',
+      },
+    ],
+
+    // Import rules - disabled for simpler setup
+    'import/order': 'off',
+    'import/no-unresolved': 'off', // TypeScript handles this
+    'import/no-named-as-default-member': 'off', // fs-extra usage pattern
+
+    // General
+    'no-console': ['warn', { allow: ['warn', 'error', 'log'] }],
+    'prefer-const': 'error',
+    'no-unused-expressions': 'error',
+  },
+  overrides: [
+    {
+      // Test files
+      files: ['tests/**/*.ts', '**/*.test.ts', '**/*-test.ts'],
+      rules: {
+        '@typescript-eslint/no-explicit-any': 'off',
+        'no-console': 'off',
+      },
+    },
+    {
+      // Config files
+      files: ['*.cjs', '*.mjs', '*.js'],
+      rules: {
+        '@typescript-eslint/no-var-requires': 'off',
+      },
+    },
+  ],
+  ignorePatterns: ['dist/', 'node_modules/', '*.d.ts'],
+};

.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

.github/workflows/ci.yml

@@ -0,0 +1,70 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+      - 'v*'
+  pull_request:
+    branches:
+      - main
+  schedule:
+    # Run daily at 3am UTC
+    - cron: '0 3 * * *'
+
+jobs:
+  test:
+    name: Test (${{ matrix.os }}, Node ${{ matrix.node }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        node: [18, 20, 22]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Type check
+        run: npm run typecheck
+
+      - name: Test
+        run: npm test
+
+  coverage:
+    name: Coverage
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Test with coverage
+        run: npm run test:coverage

.gitignore

@@ -0,0 +1,29 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# TypeScript
+*.tsbuildinfo
+
+# Test coverage
+coverage/
+
+# Logs
+*.log
+npm-debug.log*
+
+# Environment
+.env
+.env.local

.npmignore

@@ -0,0 +1,19 @@
+# Source files (dist is published)
+src/
+tests/
+.github/
+
+# Config files
+tsconfig.json
+.eslintrc.cjs
+.prettierrc
+.prettierignore
+vitest.config.ts
+
+# Build artifacts
+*.tsbuildinfo
+coverage/
+
+# Development
+.vscode/
+.idea/

.prettierignore

@@ -0,0 +1,3 @@
+dist/
+node_modules/
+*.md

.prettierrc

@@ -0,0 +1,9 @@
+{
+  "printWidth": 100,
+  "singleQuote": true,
+  "trailingComma": "es5",
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "tabWidth": 2,
+  "semi": true
+}