Skip to main content
Glama
Seroost Search MCP Server

Seroost Search MCP Server

by Parado-xy

Seroost Search MCP Server

A Model Context Protocol (MCP) server that provides AI agents with powerful codebase search capabilities using the Seroost semantic search engine.

Features

  • Semantic Code Search: Find functions, classes, and code patterns using natural language queries

  • Ranked Results: Get relevance-scored search results with line numbers and file paths

  • Fast Indexing: Quick indexing of entire codebases including dependencies

  • MCP Integration: Works with any MCP-compatible AI system (Claude, VS Code Copilot, etc.)

  • JSON API: Structured responses perfect for programmatic use

Related MCP server: Acemcp

Prerequisites

  • Node.js 18+

  • Seroost installed and built in release mode

  • TypeScript (for development)

Installation

  1. Install Seroost (if not already installed):

    # Clone and build Seroost
    git clone https://github.com/Parado-xy/seroost
    cd seroost
    cargo build --release
    # Make sure the binary is in your PATH
  2. Clone this repository:

    git clone https://github.com/Parado-xy/semantic-search-mcp
    cd search-mcp
  3. Install dependencies:

    npm install
  4. Build the project:

    npm run build

Usage

As an MCP Server

Configure your MCP client to use this server:

{
  "mcpServers": {
    "seroost-search": {
      "command": "node",
      "args": ["/path/to/search-mcp/build/index.js"]
    }
  }
}

Available Tools

seroost_set_index

Configure the target directory for indexing.

Parameters:

  • path (string): Absolute path to the directory to index

Example:

{
  "name": "seroost_set_index",
  "arguments": {
    "path": "/home/user/my-project"
  }
}

seroost_index

Build the search index for the configured directory.

Parameters: None (uses path set by seroost_set_index)

Example:

{
  "name": "seroost_index",
  "arguments": {}
}

Search through the indexed codebase.

Parameters:

  • query (string): Search term, function name, or natural language description

Example:

{
  "name": "seroost_search",
  "arguments": {
    "query": "user authentication functions"
  }
}

Response:

{
  "query": "user authentication functions",
  "results": [
    {
      "rank": 1,
      "path": "/home/user/project/src/auth.js",
      "score": 0.8543,
      "line_matches": [
        {
          "line": 42,
          "content": "function authenticateUser(credentials) {"
        }
      ]
    }
  ]
}

Workflow

  1. Set Index Path: Use seroost_set_index to configure which directory to search

  2. Build Index: Run seroost_index to process and index all files

  3. Search: Use seroost_search to find relevant code with natural language queries

Example Searches

  • "function createUser" - Find user creation functions

  • "error handling" - Find error handling patterns

  • "database connection" - Find database-related code

  • "React components" - Find React component definitions

  • "API endpoints" - Find REST API route definitions

Development

Building

npm run build

Project Structure

src/
├── index.ts        # MCP server setup and tool definitions
├── commands.ts     # Seroost command wrappers
build/              # Compiled JavaScript output

How It Works

This MCP server acts as a bridge between AI agents and the Seroost search engine:

  1. Indexing: Seroost processes your codebase and creates a searchable index

  2. Querying: AI agents send search queries through the MCP protocol

  3. Results: Seroost returns ranked, relevant code snippets with metadata

  4. Integration: AI agents can use these results to understand and work with your code

Benefits for AI Agents

  • Faster Code Discovery: Find relevant code without reading entire files

  • Semantic Understanding: Search by intent, not just exact text matches

  • Contextual Results: Get ranked results with relevance scores

  • Large Codebase Support: Handle projects with thousands of files

  • Cross-File Analysis: Find usage patterns across the entire project

License

ISC

Contributing

Contributions welcome! Please feel free to submit issues and pull requests.

Available Tools

3 tools
seroost_indexA

Build the search index for the previously configured directory path. This processes all files in the target directory and creates a searchable index. Must run after setting the index path with seroost_set_index. Indexing may take time for large codebases but enables fast subsequent searches.

Inputs: no named parameters.

seroost_set_indexA

Configure the target directory for Seroost indexing. This sets the root path that will be indexed when the index command is run. Must be called before indexing to specify which codebase directory to search.

Inputs: path (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: seroost_set_index configures the directory, seroost_index builds the index, and seroost_search performs searches. The descriptions clearly differentiate the setup, indexing, and querying phases of the workflow, making misselection unlikely.

    Naming Consistency5/5

    All tool names follow a consistent 'seroost_' prefix with descriptive action-object patterns (set_index, index, search). The naming is uniform and predictable, using snake_case throughout without any deviations or mixed conventions.

    Tool Count5/5

    With 3 tools, the server is well-scoped for its purpose of code search indexing and querying. Each tool earns its place by covering essential steps: configuration, indexing, and searching, which is appropriate for a focused search functionality without unnecessary bloat.

    Completeness5/5

    The tool set provides complete coverage for the search domain, including configuration (set_index), index building (index), and querying (search). There are no obvious gaps—agents can fully manage the search workflow from setup to execution without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables semantic code search across multiple repositories using natural language queries. Provides intelligent code discovery, symbol lookups, and cross-repo dependency analysis for AI coding agents.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables semantic code search across codebases with automatic incremental indexing. Searches return relevant code snippets with file paths and line numbers based on natural language queries.
      1
      805
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides semantic code search and retrieval capabilities for AI agents, enabling them to query codebases using natural language with automatic learning, hybrid search, and intelligent chunking of functions and classes.
      21 npm
      31
      ISC
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to semantically search and navigate code repositories using natural language, with support for multiple repos, incremental indexing, and no local install needed.
      -