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:

{ "filePath": "sample/test.txt", "keyword": "sample", "caseSensitive": false }

Output:

{ "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

# 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

Install Node.js and npm (if not already installed)
Install MCP Inspector:
npm install -g @modelcontextprotocol/inspector
Create a test configuration file (e.g., test-config.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.
Run MCP Inspector:
mcp-inspector --config test-config.json
In MCP Inspector:
- Select the search_in_file tool
- Use the following test input:
  { "filePath": "sample/test.txt", "keyword": "sample", "caseSensitive": false }
- Click "Call Tool" and verify the output shows matching lines with line numbers