LPS MCP

Descripción General

LPS MCP es un servidor con funciones mínimas para proporcionar herramientas avanzadas para Claude, permitiendo acceso seguro al sistema de archivos y capacidades de pensamiento secuencial. Este servidor forma parte de la infraestructura de LPS para mejorar las capacidades de los asistentes de IA en entornos de trabajo.

Características

• Acceso Seguro al Sistema de Archivos: Navegación y funciones de solo lectura de archivos con límites de seguridad
• Herramienta de Pensamiento Secuencial: Capacidad para desglosar problemas complejos en pasos de pensamiento estructurados
• Configuración Personalizable: Control sobre qué directorios son accesibles

Requisitos Previos

• Python 3.10 o superior
• UV (administrador de paquetes Python) instalado y en el PATH del sistema
• Claude Desktop (versión más reciente)

Instalación

1. Instalar UV (si aún no está instalado):

# Para Windows (PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Para macOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh

1. Verificar que UV esté en el PATH:

uv --version

1. Clonar o descargar este repositorio:

git clone https://github.com/lpsDevelopers/LPS-MCP
cd mcp-lps

1. Instalar dependencias:

uv pip install "mcp[cli]"

Configuración con Claude Desktop

1. Abra las configuraciones de Claude Desktop (menú Claude → Configuración → Desarrollador → Editar Configuración)

2. Añada la siguiente configuración a su archivo claude_desktop_config.json:

{
  "mcpServers": {
    "lps-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/LPS-MCP",
        "run",
        "server.py",
        "path/to/directory"
      ]
    }
  }
}

Importante: Reemplace path/to/LPS-MCP con la ruta absoluta al directorio donde está guardado server.py. El último parámetro es el directorio al que se permitirá acceso (puede añadir múltiples directorios separándolos con comas).

Idiomas: Para usar las herramientas con descripciones en español, seleccione server_es.py

1. Reinicie Claude Desktop para cargar la nueva configuración.

Herramientas Disponibles

Herramientas de Sistema de Archivos

• read_file: Lee el contenido de un archivo
• read_multiple_files: Lee varios archivos simultáneamente
• list_directory: Muestra archivos y directorios en una ubicación
• directory_tree: Muestra la estructura de directorios en formato JSON
• search_files_tool: Busca archivos por nombre
• get_file_info: Muestra metadatos de archivos
• list_allowed_directories: Lista los directorios permitidos

Herramienta de Pensamiento Secuencial

• sequentialthinking: Permite a Claude desglosar problemas complejos en pasos de pensamiento estructurados, con capacidad para:
• Seguir una secuencia lógica de pensamientos
• Revisar pensamientos anteriores
• Crear ramificaciones para explorar diferentes enfoques
• Ajustar dinámicamente el número de pasos necesarios

Uso

Una vez configurado, puede pedirle a Claude que:

1. Lea archivos de las ubicaciones permitidas:
2. "¿Puedes leer el archivo [ruta]?"

3. "Muéstrame el contenido de [ruta]"

4. Explore directorios:

5. "¿Qué archivos hay en [directorio]?"

6. "Muéstrame la estructura de archivos en [directorio]"

7. Utilice pensamiento secuencial:

8. "Analiza paso a paso el siguiente problema: [problema]"

9. "Desarrolla un plan para [tarea] usando pensamiento secuencial"

10. Combinar herramientas:

    • Una vez que Claude haya tomado conocimiento sobre la estructura de un proyecto leyendo la información, puede pedirle que use el pensamiento secuencial para intentar deducir una solución a un problema complejo relacionado con el código.

Seguridad

Este servidor implementa estrictas medidas de seguridad:

• Acceso restringido solo a los directorios explícitamente permitidos
• Resolución de enlaces simbólicos para prevenir bypass de seguridad
• Validación de todas las rutas solicitadas
• Modo de solo lectura para evitar modificaciones no autorizadas

Solución de Problemas

• El servidor no aparece en Claude: Asegúrese de que UV esté correctamente instalado y en el PATH, y que las rutas en el archivo de configuración sean correctas.
• Error de acceso denegado: Verifique que esté intentando acceder a directorios dentro de las rutas permitidas.
• Claude no encuentra las herramientas: Reinicie Claude Desktop después de modificar la configuración.

LPS