Ressl AI MCP Server
MCP server for file search functionality with support for both partial and exact word matching.
Features
- Partial Keyword Search: Find all occurrences of a keyword including partial matches
- Exact Word Search: Match complete words only with optional case sensitivity
- Detailed Results: Line numbers, column positions, and matched text for all occurrences
- MCP Inspector Integration: Built-in support for testing with MCP Inspector
Installation
npm install
Usage
Build the Project
npm run build
Run with MCP Inspector
npm start
This will automatically build the project and launch the MCP Inspector for testing.
Development Mode
npm run dev
Runs TypeScript compiler in watch mode for continuous development.
Available Tools
1. search_in_file
Searches for a keyword within a file, finding all occurrences including partial matches.
Parameters:
filePath(string, required): Path to the file to search inkeyword(string, required): Keyword to search for
Example:
{
"filePath": "./sample.txt",
"keyword": "search"
}
Result: Finds "search", "searching", "researcher", etc.
2. exact_word_search
Searches for exact word matches within a file using word boundaries.
Parameters:
filePath(string, required): Path to the file to search inword(string, required): Exact word to search forcaseSensitive(boolean, optional): Whether search should be case sensitive (default: false)
Example:
{
"filePath": "./sample.txt",
"word": "search",
"caseSensitive": false
}
Result: Finds only exact "search" matches, not "searching" or "researcher"
Testing
A sample.txt file is included in the project for testing purposes.
Test Cases
| Search Term | Tool | Matches in "searching" |
|---|---|---|
| "search" | search_in_file | Yes (partial match) |
| "search" | exact_word_search | No (exact word only) |
| "AI" | search_in_file | Yes (finds "Ressl AI" and "AIR") |
| "AI" | exact_word_search | Only "Ressl AI" (not "AIR") |
Using MCP Inspector
- Run
npm startto launch the inspector - Open the provided URL in your browser
- Select a tool from the Tools tab
- Enter the required parameters
- Click Execute to see results