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 forcaseSensitive(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_MCPwith your actual project path. -
Run MCP Inspector:
mcp-inspector --config test-config.json -
In MCP Inspector:
- Select the
search_in_filetool - 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
- Select the