Seroost Search

MCP Server for Sematic Searching

javascript

6

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 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": {
    "parado-xy-semantic-search-mcp": {
      "command": "node",
      "args": [
        "/path/to/search-mcp/build/index.js"
      ]
    }
  }
}

You run a specialized MCP server that layers Seroost’s semantic code search capabilities on top of your codebase, enabling AI agents to locate functions, classes, and patterns with natural language queries. It returns ranked results with file paths and line numbers, helping you understand and navigate large codebases quickly.

How to use

To use this MCP server with an MCP client, configure your client to connect through the provided runtime and call the available search tools. You will index your codebase, then query it with natural language terms or exact function names to retrieve relevant code snippets across the project.

How to install

Prerequisites and initial setup ensure you have the right language runtime and tooling before you begin.

Install Seroost if it is not already installed.

Clone and build Seroost locally.

# 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

Set up the MCP server project and install dependencies.

git clone https://github.com/Parado-xy/semantic-search-mcp
cd search-mcp
npm install

Build the MCP server project so it is ready to run.

npm run build

Configuration and startup notes

This server is designed to be run locally as a standard MCP stdio host. You start it via a node command pointing to the built entry script.

Tips for using the server with an MCP client

Set up indexing before querying: configure the index path and run the indexer to parse your codebase.
Use natural language queries to locate functions, patterns, and components across files and dependencies.

Available tools

seroost_set_index

Configures the target directory to index for the Seroost search engine.

seroost_index

Builds the search index for the configured directory using the path set by seroost_set_index.

seroost_search

Queries the indexed codebase. Provides a ranked list of results with file paths and line numbers.