MkDocs MCP Search Server

MIT License
2
  • Apple
  • Linux

Servidor de búsqueda MkDocs MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona funcionalidad de búsqueda para cualquier sitio web con MkDocs . Este servidor se basa en la implementación de búsqueda existente de MkDocs mediante el motor de búsqueda Lunr.Js.

Guía de inicio rápido de Claude Desktop

Siga las instrucciones de instalación. Consulte la Guía de inicio rápido del Protocolo de Contexto de Modelo para usuarios de Claude Desktop . Deberá agregar una sección al archivo de configuración de MCP como se indica a continuación:

{ "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" ] } } }

Descripción general

Este proyecto implementa un servidor MCP que permite a los Modelos de Lenguaje Grandes (LLM) buscar en cualquier sitio de documentación mkdocs publicada. Utiliza lunr.js para una búsqueda local eficiente y proporciona resultados que pueden resumirse y presentarse a los usuarios.

Características

  • Servidor compatible con MCP para integración con LLM
  • Búsqueda local utilizando índices de lunr.js
  • Capacidad de búsqueda de documentación específica de la versión

Instalación

# Install dependencies pnpm install # Build the project pnpm build

Uso

El servidor se puede ejecutar como un servidor MCP que se comunica a través de stdio:

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

Herramienta de búsqueda

El servidor proporciona una herramienta search_docs con los siguientes parámetros:

  • search : La cadena de consulta de búsqueda
  • version : cadena de versión opcional (predeterminada en 'última')

Desarrollo

Edificio

pnpm build

Pruebas

pnpm test

Configuración de MCP de Claude Desktop

Durante el desarrollo, puede ejecutar el servidor MCP con Claude Desktop utilizando la siguiente configuración.

La siguiente configuración se ejecuta en el escritorio de Windows Claude mientras se desarrolla con el Subsistema de Windows para Linux (WSL). En entornos Mac o Linux, la ejecución es similar.

La salida es un archivo incluido que permite que Node instalado en Windows ejecute el servidor MCP ya que todas las dependencias están incluidas.

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

Cómo funciona

  1. El servidor carga índices lunr.js prediseñados para cada entorno de ejecución compatible
  2. Cuando se recibe una solicitud de búsqueda, se realiza lo siguiente:
    • Carga el índice apropiado según la versión (actualmente fijada a la más reciente)
    • Realiza la búsqueda utilizando lunr.js
    • Devuelve los resultados de la búsqueda como JSON
  3. El LLM puede luego utilizar estos resultados para encontrar páginas de documentación relevantes.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

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

Permite a Claude y otros LLM buscar en cualquier sitio de documentación publicada de MkDocs utilizando el motor de búsqueda Lunr.js, lo que permite que la IA encuentre y resuma la documentación relevante para los usuarios.

  1. Guía de inicio rápido de Claude Desktop
    1. Descripción general
      1. Características
        1. Instalación
          1. Uso
            1. Herramienta de búsqueda
          2. Desarrollo
            1. Edificio
            2. Pruebas
            3. Configuración de MCP de Claude Desktop
          3. Cómo funciona
            1. Licencia

              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