scalvert/docusaurus-plugin-mcp-server

Documentation · 시작 · 배포 가이드 · 참조

MCP (Model Context Protocol) 서버 엔드포인트를 노출시킨 Docusaurus 플러그인은 Claude, Cursor 및 기타 MCP 호환 도구를 사용하여 문서를 검색하고 검색할 수 있습니다.

서버는 MCP 2026-07-28를 말하고 여전히 동일한 엔드포인트에서 2025-era 개정 ([T0]]]핸드레이크)에 클라이언트를 제공합니다. docs 도구를 사용하는 방법을 가르치는 Agent Skills도 제공 할 수 있습니다.

문서 사이트는이 플러그인을 기반으로합니다. 에이전트를 연결:

설치

빠른 시작

##1. 플러그인 추가

url 에서 docusaurus.config.js] 을 생산 도메인에 설정: 도구 결과의 페이지 URL은 그것에서 내장.

##2. API 엔드포인트 생성

docusaurus build] build/mcp/bundle.json]에 artifact 번들을 작성한다. /mcp]와 createWebRequestHandler]에서 함수를 세울 때, 어떤 serverless 또는 edge runtime에 대한 표준 (request: Request) => Promise ]를 반환합니다.

그 파일이 어떻게 간다 /mcp]는 호스트에 따라 경로입니다. 각 가이드는 완전한 설치입니다:

A Docusaurus plugin that exposes an MCP (Model Context Protocol) server endpoint, allowing AI agents like Claude, Cursor, and other MCP-compatible tools to search and retrieve your documentation.

The server speaks MCP 2026-07-28 and still serves clients on 2025-era revisions (the initialize handshake) from the same endpoint. It can also serve Agent Skills that teach agents how to use your docs tools.

The documentation site is built with this plugin. Connect your agent to it:

claude mcp add --transport http docusaurus-plugin-mcp-server https://docusaurus-plugin-mcp-server.vercel.app/mcp

Installation

npm install docusaurus-plugin-mcp-server

Quick Start

1. Add the Plugin

// docusaurus.config.js
module.exports = {
  plugins: [
    [
      'docusaurus-plugin-mcp-server',
      {
        server: {
          name: 'my-docs',
          version: '1.0.0',
        },
      },
    ],
  ],
};

Set url in docusaurus.config.js to your production domain: page URLs in tool results are built from it.

2. Create the API Endpoint

docusaurus build writes the artifact bundle to build/mcp/bundle.json. Serve it from a function at /mcp with createWebRequestHandler, which returns a standard (request: Request) => Promise for any serverless or edge runtime:

import { createWebRequestHandler } from 'docusaurus-plugin-mcp-server/adapters';
import bundle from '../build/mcp/bundle.json' with { type: 'json' };

export default {
  // Name, version, and site URL come from the build; pass them here to override.
  fetch: createWebRequestHandler({ artifacts: bundle }),
};

Where that file goes and how /mcp is routed to it depends on your host. Each guide is a complete setup: