Ressl MCP

# Ressl_MCP MCP (Model Context Protocol) server implementation with a file search tool. ## Features - search_in_file: Searches for a specified keyword within a file and returns matching lines with line numbers - Supports case-sensitive and case-insensitive searches - Returns line numbers for easy reference - Handles file path resolution (relative and absolute paths) ## MCP Configuration To use this server with an MCP client, add the following configuration: ### MCP Inspector When using MCP Inspector, configure the server with: - Command: `python` - Args: `["/absolute/path/to/Ressl_MCP/src/server.py"]` ## Tool: search_in_file ### Parameters - `filePath` (required): The path to the file to search in (relative or absolute) - `keyword` (required): The keyword or phrase to search for - `caseSensitive` (optional): Whether the search should be case-sensitive (default: false) ### Example Usage Input: ```json { "filePath": "sample/test.txt", "keyword": "sample", "caseSensitive": false } ``` Output: ```json { "filePath": "/absolute/path/to/Ressl_MCP/sample/test.txt", "keyword": "sample", "caseSensitive": false, "totalMatches": 3, "matches": [ { "lineNumber": 1, "content": "This is a sample file for testing the file search tool." }, { "lineNumber": 4, "content": "This line contains the word sample again." }, { "lineNumber": 7, "content": "The search tool should find all occurrences." } ] } ``` ## Setup Sample files are provided in the `sample/` directory: - `sample/test.txt` - Simple text file with multiple occurrences of "sample" ### Set Up Environment ```bash # Create virtual environment python3 -m venv venv # Activate virtual environment source venv/bin/activate # Install dependencies pip install -r requirements.txt ``` ### Test with MCP Inspector 1. Install Node.js and npm (if not already installed) 2. Install MCP Inspector: ```bash npm install -g @modelcontextprotocol/inspector ``` 3. Create a test configuration file (e.g., `test-config.json`): ```json { "mcpServers": { "file-search-server": { "command": "python", "args": ["/absolute/path/to/Ressl_MCP/src/server.py"] } } } ``` Replace `/absolute/path/to/Ressl_MCP` with your actual project path. 4. Run MCP Inspector: ```bash mcp-inspector --config test-config.json ``` 5. In MCP Inspector: - Select the `search_in_file` tool - Use the following test input: ```json { "filePath": "sample/test.txt", "keyword": "sample", "caseSensitive": false } ``` - Click "Call Tool" and verify the output shows matching lines with line numbers