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