🔍 Search Tools MCP Server

⚡ An intelligent Model Context Protocol (MCP) server that supercharges code analysis with advanced search capabilities and dependency mapping

🌟 Overview

The Search Tools MCP Server is a powerful toolkit that combines traditional code search with intelligent analysis algorithms. It leverages the CodeRank algorithm (inspired by PageRank) to identify the most critical modules in your codebase and provides sophisticated search capabilities that go beyond simple text matching.

🎯 Key Features

🔎 Smart Search Capabilities

• Contextual Keyword Search: Ripgrep-powered search with configurable context lines
• Symbol Discovery: Extract and analyze functions, classes, methods, and modules
• Usage Tracking: Find where symbols are used across your codebase
• Priority-Ranked Results: Search results ranked by code importance

🧠 Intelligence & Analysis

• CodeRank Algorithm: Identify the most critical modules using network analysis
• Dependency Mapping: Trace complex dependency chains and impact analysis
• Hotspot Detection: Find code areas that are both highly connected and frequently used
• Refactoring Impact: Analyze the potential impact of code changes

🎨 Advanced Filtering

• Symbol type filtering (functions, methods, classes)
• File inclusion/exclusion patterns
• External module dependency tracking
• Markdown documentation analysis

🛠️ Installation

Prerequisites

• Python 3.13+
• uv package manager
• kit CLI tool (for symbol analysis)
• ripgrep (for fast text search)

Setup

# Clone the repository
git clone 
cd search-tools

# Install dependencies
uv sync

⚙️ Configuration

Adding to Cursor/Windsurf

Add the following configuration to your mcp.json file:

{
  "mcpServers": {
    "search-tools": {
      "command": "/path/to/uv",
      "args": [
        "run",
        "--directory",
        "/path/to/search-tools",
        "main.py"
      ]
    }
  }
}

For macOS users with Homebrew:

{
  "mcpServers": {
    "search-tools": {
      "command": "/Users/yourusername/.local/bin/uv",
      "args": [
        "run",
        "--directory",
        "/path/to/your/search-tools/directory",
        "main.py"
      ]
    }
  }
}

To add to claude code:

claude mcp add-json search-tools '{"type":"stdio","command":"/Users/yourusername/.local/bin/uv","args":[ "run", "--directory", "/path/to/your/search-tools/directory", "main.py"]}'

📍 Finding Your Paths

To find the correct paths for your system:

# Find uv location
which uv

# Get absolute path to search-tools directory  
pwd  # (run this from the search-tools directory)

🚀 Available Tools

🔍 contextual_keyword_search

Search for keywords with configurable context lines around matches.

Parameters:

• keyword: Search term (case insensitive)