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

1. Install Node.js and npm (if not already installed)

2. Install MCP Inspector:

   npm install -g @modelcontextprotocol/inspector

3. 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.

4. Run MCP Inspector:

   mcp-inspector --config test-config.json

5. 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