LPS MCP - Tool Server for Claude

General Description

LPS MCP is a minimally functional server designed to provide advanced tools for Claude, enabling secure file system access and sequential thinking capabilities. This server is part of the LPS infrastructure to enhance the capabilities of AI assistants in work environments.

Characteristics

• Secure File System Access : Browsing and read-only file functions with security limits
• Sequential Thinking Tool : Ability to break down complex problems into structured thinking steps
• Customizable Settings : Control over which directories are accessible

Prerequisites

• Python 3.10 or higher
• UV (Python package manager) installed and in the system PATH
• Claude Desktop (latest version)

Facility

1. Install UV (if not already installed):
   # 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. Verify that UV is in the PATH :
   uv --version
3. Clone or download this repository:
   git clone https://github.com/lpsDevelopers/LPS-MCP cd mcp-lps
4. Install dependencies :
   uv pip install "mcp[cli]"

Configuration with Claude Desktop

1. Open Claude Desktop settings (Claude menu → Settings → Developer → Edit Settings)
2. Add the following configuration to your claude_desktop_config.json file:
   { "mcpServers": { "lps-mcp": { "command": "uv", "args": [ "--directory", "path/to/LPS-MCP", "run", "server.py", "path/to/directory" ] } } }
   Important : Replace path/to/LPS-MCP with the absolute path to the directory where server.py is stored. The last parameter is the directory to which access will be granted (you can add multiple directories by separating them with commas).Languages : To use tools with Spanish descriptions, select server_es.py
3. Restart Claude Desktop to load the new settings.

Available Tools

File System Tools

• read_file : Reads the contents of a file
• read_multiple_files : Read multiple files simultaneously
• list_directory : Displays files and directories in a location
• directory_tree : Displays the directory structure in JSON format
• search_files_tool : Search for files by name
• get_file_info : Displays file metadata
• list_allowed_directories : Lists allowed directories

Sequential Thinking Tool

• sequentialthinking : Allows Claude to break down complex problems into structured thinking steps, with the ability to:
  • Follow a logical sequence of thoughts
  • Review previous thoughts
  • Create branches to explore different approaches
  • Dynamically adjust the number of steps required

Use

Once set up, you can ask Claude to:

1. Read files from allowed locations:
   • "Can you read the file [path]?"
   • "Show me the contents of [path]"
2. Explore directories :
   • "What files are in [directory]?"
   • "Show me the file structure in [directory]"
3. Use sequential thinking :
   • "Analyze the following problem step by step: [problem]"
   • "Develop a plan for [task] using sequential thinking"
4. Combine tools :
   • Once Claude has learned about project structure by reading the information, you can ask him to use sequential thinking to try to deduce a solution to a complex code-related problem.

Security

This server implements strict security measures:

• Restricted access to only explicitly allowed directories
• Resolving symbolic links to prevent security bypasses
• Validation of all requested routes
• Read-only mode to prevent unauthorized modifications

Troubleshooting

• The server is not showing up in Claude : Make sure UV is installed correctly and in the PATH, and that the paths in the configuration file are correct.
• Access Denied Error : Please verify that you are trying to access directories within the allowed paths.
• Claude cannot find the tools : Restart Claude Desktop after changing the settings.

LPS