Skip to main content
Glama
Vaishnavi-Raykar

Ressl AI MCP Server

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

Related MCP server: MCP Keyword Search

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 in

  • keyword (string, required): Keyword to search for

Example:

{
  "filePath": "./sample.txt",
  "keyword": "search"
}

Result: Finds "search", "searching", "researcher", etc.

Searches for exact word matches within a file using word boundaries.

Parameters:

  • filePath (string, required): Path to the file to search in

  • word (string, required): Exact word to search for

  • caseSensitive (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

  1. Run npm start to launch the inspector

  2. Open the provided URL in your browser

  3. Select a tool from the Tools tab

  4. Enter the required parameters

  5. Click Execute to see results

Available Tools

2 tools
search_in_fileA

Search for a keyword within a specified file. Finds all occurrences including partial matches.

ParametersJSON Schema
NameRequiredDescriptionDefault
filePathYesPath to the file to search in
keywordYesKeyword to search for in the file

TDQS

A3.9/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It discloses the tool's behavior of finding all occurrences with partial matches, which is useful. However, it lacks details on error handling (e.g., what happens if the file doesn't exist), output format (e.g., line numbers, context), or performance aspects like case sensitivity, which are important for a search operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences with zero waste: the first sentence states the core purpose, and the second adds critical behavioral detail (partial matches). It is front-loaded and appropriately sized, with every sentence earning its place by providing essential information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's moderate complexity (search operation with two parameters), no annotations, and no output schema, the description is minimally complete. It covers the basic purpose and key behavior (partial matches) but lacks details on output format, error handling, or advanced usage, leaving gaps that could hinder an AI agent's effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, meaning the input schema already fully documents the parameters 'filePath' and 'keyword'. The description adds no additional semantic details beyond what the schema provides (e.g., no examples, constraints, or usage tips), so it meets the baseline of 3 without compensating further.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the specific action ('Search for a keyword'), target resource ('within a specified file'), and scope ('Finds all occurrences including partial matches'). It distinguishes from the sibling tool 'exact_word_search' by explicitly mentioning partial matches, which implies the sibling likely does exact matches only.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear context for when to use this tool (searching within files for keywords with partial matching). However, it does not explicitly state when not to use it or name the alternative sibling tool 'exact_word_search' as a direct comparison, though the distinction is implied through the mention of partial matches.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

TDQS

A3.6/5.0
Disambiguation2/5

The two tools have overlapping purposes, both searching within files, with only subtle differences in matching behavior (exact word vs. keyword with partial matches). This creates ambiguity, as an agent might struggle to choose between them without understanding the nuanced distinction, and they could easily be confused for similar tasks.

Naming Consistency4/5

The tool names follow a consistent snake_case pattern (exact_word_search, search_in_file) and use clear verbs ('search'), which aids readability. However, the naming is not perfectly consistent, as one specifies 'exact_word' while the other uses 'in_file', but overall, the pattern is predictable and coherent.

Tool Count2/5

With only 2 tools, the server feels thin and under-scoped for a general-purpose AI MCP server, suggesting limited functionality. This low count may not adequately cover the domain implied by the server name, potentially leaving gaps in capabilities and making it less useful for agents.

Completeness2/5

Inferred as a file search domain, the tool set is severely incomplete, lacking basic operations like listing files, reading file contents, or handling multiple files. The two tools only cover specific search variations, leaving significant gaps that will likely cause agent failures in broader tasks.

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables intelligent file searching in local directories using natural language queries. Supports searching by file type, filename patterns, and content across multiple formats including PDF, Word, Excel, and text files with AI-powered relevance scoring.
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables searching for keywords within files with case-sensitive/insensitive options, returning matching lines with line numbers for easy reference.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Vaishnavi-Raykar/mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server