MCP Docs Server

Servidor MCP Docs

Un servidor ligero de Protocolo de Contexto de Modelos (MCP) que proporciona acceso directo a archivos de documentación locales: una alternativa simple a los complejos pipelines de RAG para contexto específico de proyectos.

Resumen

Este servidor MCP lee un único archivo markdown (context.md) y expone su contenido a través de dos herramientas simples:

• get_context_overview(): Lista todos los títulos de secciones
• search_context(query): Busca contenido en todas las secciones

Perfecto para dar a los LLMs acceso a la documentación del proyecto sin la sobrecarga de bases de datos vectoriales o modelos de embeddings.

Características

• Cero dependencias más allá del SDK de Python de MCP
• Rápido como un rayo: acceso directo a archivos, sin búsqueda vectorial
• Configuración simple: funciona con clientes MCP tanto GUI como CLI
• Multiplataforma: incluye un wrapper de shell para compatibilidad con macOS/Linux
• Manejo robusto de errores: registro y soporte de depuración completos

Instalación

Requisitos previos

• Python 3.11+
• Cliente MCP (Claude Desktop, cline, etc.)

Configuración

1. Clona este repositorio:

git clone https://github.com/unlock-mcp/mcp-docs-server.git
cd mcp-docs-server

2. Instala las dependencias:

pip install -r requirements.txt

3. Crea tu archivo de documentación:

# Create a context.md file in the project root with your documentation
echo "# My Project Docs\n\nThis is my documentation." > context.md

Configuración del cliente

Para Claude Desktop (clientes GUI)

Usa el wrapper de shell para una ejecución confiable:

1. Haz ejecutable el wrapper:

chmod +x run_context_server.sh

2. Instala el servidor:

mcp install ./run_context_server.sh --name "docs-server"

Para cline y clientes CLI

Añade a tu archivo de configuración de MCP:

{
  "mcpServers": {
    "docs-server": {
      "timeout": 60,
      "type": "stdio",
      "command": "/opt/homebrew/bin/python3.11",
      "args": [
        "/path/to/mcp-docs-server/mcp_context_server.py"
      ],
      "env": {}
    }
  }
}

Nota: Actualiza la ruta de Python para que coincida con tu sistema (which python3.11)

Desarrollo

Pruebas

Usa las herramientas de desarrollo de MCP para pruebas fáciles:

mcp dev ./run_context_server.sh

Esto lanza un inspector basado en web para probar tu servidor.

Depuración

El servidor registra en stderr para depuración. Revisa los registros de tu cliente MCP si encuentras problemas.

Problemas comunes:

• Errores ENOENT: Usa el wrapper de shell o especifica la ruta completa de Python
• Errores de importación: Asegúrate de que mcp[cli]>=1.2.0 esté instalado
• Archivo no encontrado: Verifica que context.md exista en la raíz del proyecto

Estructura de archivos

mcp-docs-server/
├── mcp_context_server.py      # Main server implementation
├── run_context_server.sh      # Shell wrapper for GUI clients
├── requirements.txt           # Python dependencies
├── context.md                 # Your documentation (create this)
└── README.md                  # This file

Uso

Una vez configurado, puedes usar estas herramientas en tu cliente MCP:

• Obtener resumen: "¿Qué secciones están disponibles en los documentos?"
• Buscar contenido: "Busca autenticación en los documentos"
• Consultas específicas: "¿Cómo configuro la base de datos?"

Tutorial

Para un recorrido completo de cómo construir este servidor desde cero, incluidos errores comunes y soluciones, consulta el tutorial completo: Ditching RAG: Building a Local MCP Server for Your Docs

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar problemas y solicitudes de extracción.

Licencia

Licencia MIT: consulta el archivo LICENSE para más detalles.

---

Construido con ❤️ por el equipo de UnlockMCP.