scalvert/docusaurus-plugin-mcp-server

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

35 stars 6 forks 品質 82 トレンド 32MIT

Repository Install

ドキュメントをMCPサーバーとして公開するDocusaurusプラグイン

概要

MCP (Model Context Protocol) サーバーエンドポイントを公開する Docusaurus プラグインで、Claude、Cursor、その他の MCP 互換ツールなどの AI エージェントがドキュメントを検索して取得できるようにします。 MCP サーバーは、Web 標準のサーバーレスまたはエッジランタイムで動作します。Cloudflare ワーカー、近代的な Netlify 機能、Vercel Edge、Deno、 Bun。ビルドアーティファクトをインポートし、標準(request: Request) => を返す CreateWebRequestHandler に渡す約束。 (ランタイムはファイルシステムを読み込めないため、ディスクから読み込まれるのではなくモジュールとしてデータをインポートします。) エクスポートデフォルト { fetch } フォームは、Cloudflare Workers、Deno、および Bun で動作します。他のランタイムは、独自のエントリー規約(例えば、モダンNetlify関数エクスポートデフォルト非同期(request) => Response)を使用します。ハンドラは同一で、エクスポートラッパーのみが異なります.

概要（AI 翻訳）

Documentation · はじめる · ガイドの展開 · リファレンス

MCP (Model Context Protocol) サーバーエンドポイントを公開する Docusaurus プラグインで、Claude、Cursor、その他の MCP 互換ツールなどの AI エージェントがドキュメントを検索して取得できるようにします。

サーバは、MCP 2026-07-28 を話し、同じエンドポイントから 2025 era のリビジョン (initialize) の handhake をクライアントに提供します。ドキュメントツールの使い方をエージェントに教えるエージェントスキルも提供できます。

ドキュメントサイトは、このプラグインで構築されています。エージェントをそれに接続します。

インストール

クイックスタート

##1. プラグインを追加する

url を docusaurus.config.js] に設定します。ツール結果のページの URL は、そこから作成されます。

##2. APIエンドポイントを作成する

[docusaurus build] にアーティファクトバンドルを build/mcp/bundle.json に書きます。 [/mcp で createWebRequestHandler] で関数から動作するようにします。これは、任意のサーバーレスまたはエッジランタイムの標準的な[(request: Request) => Promise ]を返します。

ファイルがどこにあるか、 [/mcp] がホストによって異なります。各ガイドは完全なセットアップです:

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

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:

Platform	Guide

GitHub で README 全文を見る

インストール

npx docusaurus-mcp-verify

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "my-docs": {
      "url": "https://docs.example.com/mcp"
    }
  }
}