Skip to main content
Glama

mcp-docs

Servidor MCP genérico que expone documentación en Markdown a LLMs, permitiéndoles buscar y responder preguntas sobre cualquier documentación de software.

La identidad del servidor (nombre, instrucciones, etiquetas de categoría) se gestiona completamente desde el directorio docs/, que es un repositorio independiente clonado junto a este.

Requisitos

  • Python 3.14+

  • uv

Related MCP server: repocks

Configuración

1. Clonar el repositorio de documentación

El directorio docs/ debe existir antes de que el servidor pueda iniciarse. Clona el repositorio de documentación dentro de él:

git clone <docs-repo-url> docs

2. Instalar dependencias

uv sync

Estructura del directorio docs/

El servidor descubre automáticamente las categorías a partir de los subdirectorios. El único archivo requerido es config.toml en la raíz de docs/.

docs/
├── config.toml          # required — project identity
├── <category>/
│   ├── <topic>.md
│   └── ...
└── <category>/
    └── ...

config.toml

[project]
name = "my-project"
instructions = """
System instructions for the LLM. Describe what this documentation covers
and how the model should use the available tools.
"""

[categories]
folder-name = "Human-readable label"
  • [project] es obligatorio. name identifica al servidor; instructions guía al LLM.

  • [categories] es opcional. Cualquier subdirectorio no listado obtiene automáticamente una etiqueta con formato de título (my-folder → My Folder).

  • Los archivos dentro de los subdirectorios img/ nunca se sirven.

Uso

Ejecutar el servidor (modo stdio)

uv run main.py

Desarrollo con MCP Inspector

uv run mcp dev main.py

Abre el MCP Inspector en el navegador. Para conectarse a un servidor SSE o HTTP en ejecución, inícielo primero y apunte el inspector al endpoint impreso:

uv run main.py --transport sse
uv run main.py --transport streamable-http

Configurar con Claude Desktop

Añada lo siguiente a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "my-project": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-docs", "run", "main.py"]
    }
  }
}

Configurar con Claude Code

claude mcp add my-project -- uv --directory /path/to/mcp-docs run main.py

Capacidades

Herramientas

Herramienta

Descripción

list_docs(category?)

Lista los archivos de documentación disponibles, opcionalmente filtrados por categoría

read_doc(category, topic)

Lee el contenido completo de un archivo de documentación

search_docs(query, category?)

Búsqueda de texto completo en toda la documentación

Recursos

URI

Descripción

docs://index

Índice completo de todos los archivos de documentación disponibles

docs://{category}/{topic}

Contenido de un archivo de documentación específico

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    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
    20 npm
    264
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Transforms Markdown documentation into an intelligent knowledge base with AI-powered search and Q\&A through an MCP server.
    20 npm
    9
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that indexes documents and serves relevant context to LLMs via Retrieval Augmented Generation (RAG).
    21 npm
    36
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    A documentation MCP server that crawls websites and Git repositories, stores them as Markdown, and provides tools to search and retrieve documentation for local LLMs and AI agents.
    Apache 2.0