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

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

Recursos