MkDocs MCP Search Server

MIT License
2
  • Apple
  • Linux

MkDocs MCP 検索サーバー

MkDocsを利用したあらゆるサイトに検索機能を提供する、モデルコンテキストプロトコル (MCP) サーバーです。このサーバーは、 Lunr.Js検索エンジンを使用した既存の MkDocs 検索実装に依存しています。

Claude デスクトップ クイックスタート

インストール手順に従ってください。Claude Desktopユーザー向けのモデルコンテキストプロトコルクイックスタートに従ってください。MCP設定ファイルに以下のセクションを追加する必要があります。

{ "mcpServers": { "my-docs": { "command": "npx", "args": [ "-y", "@serverless-dna/mkdocs-mcp", "https://your-doc-site", "Describe what you are enabling search for to help your AI Agent" ] } } }

概要

このプロジェクトは、大規模言語モデル(LLM)が公開mkdocsドキュメントサイトを検索できるようにするMCPサーバーを実装します。lunr.jsを使用して効率的なローカル検索機能を提供し、結果を要約してユーザーに提示できるようにします。

特徴

  • LLMとの統合のためのMCP準拠サーバー
  • lunr.js インデックスを使用したローカル検索
  • バージョン固有のドキュメント検索機能

インストール

# Install dependencies pnpm install # Build the project pnpm build

使用法

サーバーは、stdio 経由で通信する MCP サーバーとして実行できます。

npx -y @serverless-dna/mkdocs-mcp https://your-doc-site.com

検索ツール

サーバーは、次のパラメータを持つsearch_docsツールを提供します。

  • search : 検索クエリ文字列
  • version : オプションのバージョン文字列(デフォルトは「latest」)

発達

建物

pnpm build

テスト

pnpm test

クロードデスクトップMCP構成

開発中は、次の構成を使用して、Claude Desktop で MCP サーバーを実行できます。

以下の構成は、Windows Subsystem for Linux (WSL) を使用して開発中に Windows の claude デスクトップで実行している様子を示しています。Mac や Linux 環境でも同様の方法で実行できます。

出力はバンドル ファイルであり、すべての依存関係がバンドルされているため、Windows にインストールされた Node で MCP サーバーを実行できます。

{ "mcpServers": { "powertools": { "command": "node", "args": [ "\\\\wsl$\\Ubuntu\\home\\walmsles\\dev\\serverless-dna\\mkdocs-mcp\\dist\\index.js", "Search online documentation" ] } } }

仕組み

  1. サーバーは、サポートされているランタイムごとに事前に構築されたlunr.jsインデックスをロードします。
  2. 検索要求を受信すると、次の処理が行われます。
    • バージョンに基づいて適切なインデックスをロードします(現在は最新に固定されています)
    • lunr.jsを使用して検索を実行します
    • 検索結果をJSONとして返します
  3. LLMはこれらの結果を使用して、関連するドキュメントページを見つけることができます。

ライセンス

マサチューセッツ工科大学

-
security - not tested
A
license - permissive license
-
quality - not tested

Claude や他の LLM が Lunr.js 検索エンジンを使用して公開されている MkDocs ドキュメント サイトを検索できるようにし、AI がユーザーに関連するドキュメントを見つけて要約できるようにします。

  1. Claude デスクトップ クイックスタート
    1. 概要
      1. 特徴
        1. インストール
          1. 使用法
            1. 検索ツール
          2. 発達
            1. 建物
            2. テスト
            3. クロードデスクトップMCP構成
          3. 仕組み
            1. ライセンス

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                An MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context
                Last updated -
                7
                62
                81
                TypeScript
                MIT License
              • -
                security
                A
                license
                -
                quality
                An MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context. Uses Ollama or OpenAI to generate embeddings. Docker files included
                Last updated -
                19
                14
                TypeScript
                MIT License
                • Apple
                • Linux
              • -
                security
                F
                license
                -
                quality
                An MCP server that integrates with Claude to provide smart documentation search capabilities across multiple AI/ML libraries, allowing users to retrieve and process technical information through natural language queries.
                Last updated -
                Python
              • -
                security
                A
                license
                -
                quality
                Enables LLMs to autonomously retrieve and explore web content by fetching pages and recursively following links to a specified depth, particularly useful for learning about topics from documentation.
                Last updated -
                TypeScript
                MIT License

              View all related MCP servers

              ID: pr0745snq7