LPS MCP - Servidor de Herramientas para Claude

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
2. Verificar que UV esté en el PATH:
   uv --version
3. Clonar o descargar este repositorio:
   git clone https://github.com/lpsDevelopers/LPS-MCP cd mcp-lps
4. 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
3. 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:
   • "¿Puedes leer el archivo [ruta]?"
   • "Muéstrame el contenido de [ruta]"
2. Explore directorios:
   • "¿Qué archivos hay en [directorio]?"
   • "Muéstrame la estructura de archivos en [directorio]"
3. Utilice pensamiento secuencial:
   • "Analiza paso a paso el siguiente problema: [problema]"
   • "Desarrolla un plan para [tarea] usando pensamiento secuencial"
4. 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