Ressl

Submission for Ressl - MCP

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "vishnu-m77-ressl_mcp": {
      "command": "python",
      "args": [
        "/absolute/path/to/Ressl_MCP/src/server.py"
      ]
    }
  }
}

You can run the Ressl MCP server to expose a simple file-search capability as a tool you can call from an MCP client. This server lets you search for a keyword within a file, returning matching lines with line numbers, and supports both case-sensitive and case-insensitive searches for quick, precise lookups.

How to use

To use the server, run it locally and connect an MCP client to invoke the search tool. The server exposes a single tool named search_in_file that accepts a file path, a keyword, and an optional case sensitivity flag. You feed the tool a target file and a keyword, and you’ll receive the lines where the keyword appears along with their line numbers. You can perform multiple searches by calling the tool with different inputs.

Key capabilities you can leverage with the MCP client include: the ability to specify relative or absolute file paths, control whether the search is case sensitive, and receive precise line numbers for each match to help you quickly locate the relevant text in large files.

How to install

Prerequisites you need: a Python runtime installed on your machine and access to install Python packages.

Create a Python virtual environment to isolate dependencies.

python3 -m venv venv

Install dependencies

Activate the virtual environment and install the required dependencies from the project’s requirements file.

# Activate virtual environment
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

Run the server with MCP Inspector (optional)

If you plan to use MCP Inspector to test and call the tool, run the server as shown in the configured command. The MCP Inspector configuration uses a Python command to start the server from its source path.

python /absolute/path/to/Ressl_MCP/src/server.py

Test with an MCP client

With the server running, you can configure your MCP client to call the search_in_file tool. You will supply a file path, a keyword, and an optional caseSensitive flag. The response will include totalMatches and a list of match objects with lineNumber and content for each matching line.

Available tools

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 and resolves both relative and absolute file paths.