Skip to main content
Glama

Smart Code Search MCP Server

SCS-MCP - Smart Code Search for Claude Desktop

Version Python License MCP

An intelligent code search and analysis system with voice interaction capabilities

FeaturesInstallationUsageAPIVoice AssistantContributing


🌟 Overview

SCS-MCP is a powerful Model Context Protocol (MCP) server that brings intelligent semantic code search, analysis, and voice interaction capabilities to Claude Desktop and other MCP-compatible clients. It combines state-of-the-art embedding models with sophisticated code analysis tools to provide deep insights into your codebase.

Note from author

This project is a work in progress and is not yet production-ready. It is intended for developers who want to experiment with advanced code search and analysis features, and contribute to its development. The Indexing and search capabilities are functional, but the voice assistant and orchestration features are still in beta. Please use with caution and report any issues you encounter.

~Steve Jobson

Key Capabilities

  • 🔍 Semantic Search - Find code by meaning, not just text matching
  • 🎙️ Voice Control - Natural language voice commands for hands-free coding
  • 📸 Media History - Capture and annotate screenshots and recordings
  • 🧠 AI-Powered Analysis - Instant code reviews and quality assessments
  • 📊 Code Metrics - Complexity analysis and technical debt tracking
  • 🔄 Git Integration - Search through commit history and analyze changes
  • 🚀 High Performance - Sub-100ms search with intelligent caching
  • 🌍 Multi-Language - Support for Python, JavaScript, TypeScript, Java, Go, and more

🎯 Features

Core Search Capabilities

  • Hybrid Search: Combines semantic understanding with keyword matching
  • Context-Aware: Understands code relationships and dependencies
  • Instant Results: Optimized for speed with response caching
  • Flexible Filtering: Filter by file type, path, or custom patterns

Code Intelligence Tools

  • Instant Review: Real-time code quality feedback
  • Complexity Analysis: Identify complex code that needs refactoring
  • Test Gap Detection: Find untested code paths
  • Security Scanning: Basic vulnerability detection
  • Dependency Analysis: Track imports and circular dependencies
  • Graph Visualization: Generate dependency graphs in DOT, Mermaid, or JSON formats

Voice Assistant Integration

  • Natural Commands: "Find authentication code", "Review this function"
  • Context Awareness: Integrates with VS Code for current file context
  • Media Capture: Voice-triggered screenshots and recordings with annotation tools
  • Web UI: Beautiful interface for voice interaction and media history
  • Media Server: Full-featured screenshot/recording system with gallery and export

Orchestration Framework

  • Technical Debt Analysis: Comprehensive debt assessment
  • Refactoring Assistant: Guided refactoring suggestions
  • Migration Planning: Coordinate complex code migrations
  • Quality Gates: Automated quality checks

🚀 Installation

Quick Start

# Clone the repository git clone https://github.com/StevenJJobson/scs-mcp.git cd scs-mcp # Run the installer chmod +x scripts/install.sh ./scripts/install.sh # Configure Claude Desktop (see below)

Claude Desktop Configuration

Add to your Claude Desktop config file:

Windows (%APPDATA%\Claude\claude_desktop_config.json):

{ "mcpServers": { "scs-mcp": { "command": "wsl", "args": ["bash", "-c", "cd /path/to/scs-mcp && python3 -m src.server"] } } }

macOS/Linux (~/.config/Claude/claude_desktop_config.json):

{ "mcpServers": { "scs-mcp": { "command": "python3", "args": ["-m", "src.server"], "cwd": "/path/to/scs-mcp" } } }

For detailed installation instructions, see docs/INSTALLATION.md.

🎙️ Voice Assistant

The integrated voice assistant provides a hands-free coding experience with natural language commands.

Setup

# Navigate to voice assistant directory cd voice-assistant # Install dependencies npm install # Setup media directories npm run setup # Start the server npm start

Access the Web UI

Open your browser to: http://localhost:3000/media-ui.html

VS Code Extension

Install the companion VS Code extension for enhanced editor integration:

cd voice-assistant/vscode-extension npm install npm run compile # Press F5 in VS Code to launch

Voice Commands Examples

  • "Find all authentication functions"
  • "Review the current code for security issues"
  • "Show me similar code patterns"
  • "Take a screenshot of this error"
  • "Start recording my debugging session"
  • "What's the complexity of this function?"

📚 Usage Examples

In Claude Desktop

Once configured, you can use natural language queries:

You: Find all database connection code in the project Claude: I'll search for database connection code using the SCS-MCP tool... [Returns relevant code snippets with context] You: Review the authentication.py file for security issues Claude: Let me analyze the authentication.py file for security concerns... [Provides detailed security review with recommendations]

Available Tools

SCS-MCP provides 30+ specialized tools. Here are some highlights:

ToolDescriptionExample Use
searchSemantic code searchFind authentication logic
find_similarFind similar code patternsLocate duplicate code
instant_reviewQuick code reviewCheck code quality
analyze_symbolDeep symbol analysisUnderstand a complex class
git_search_historySearch git historyFind when bug was introduced
debt_orchestratorTechnical debt analysisIdentify refactoring priorities
generate_dependency_graphCreate dependency graphsVisualize code structure

For complete API documentation, see docs/API.md. For detailed feature descriptions, see docs/FEATURES.md.

🏗️ Architecture

SCS-MCP uses a modular architecture for scalability and extensibility:

┌─────────────────┐ │ Claude Desktop │ └────────┬────────┘ │ MCP Protocol ┌────────▼────────┐ │ MCP Server │ ├─────────────────┤ │ Search Engine │ │ Analysis Tools │ │ Orchestrators │ ├─────────────────┤ │ Database Layer │ │ Git Integration│ │ Cache System │ └─────────────────┘

For detailed architecture information, see docs/ARCHITECTURE.md.

🔧 Configuration

Create a .env file in the project root:

# Project Settings PROJECT_ROOT=/path/to/your/code PROJECT_NAME=MyProject # Performance MAX_WORKERS=4 CACHE_TTL=300 # Features ENABLE_VOICE=true ENABLE_GIT_HISTORY=true # Optional: API Keys ELEVENLABS_API_KEY=your_key_here # For text-to-speech OPENAI_API_KEY=your_key_here # For enhanced processing

📊 Performance

  • Search Speed: < 100ms for most queries
  • Indexing: ~1000 files/second
  • Memory Usage: < 500MB typical
  • Cache Hit Rate: > 80% for common queries

🧪 Testing

Run the test suite:

# Python tests python -m pytest tests/ # Voice assistant tests cd voice-assistant && npm test # Integration tests python scripts/integration_test.py

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Development Setup

# Create virtual environment python -m venv venv source venv/bin/activate # or venv\Scripts\activate on Windows # Install in development mode pip install -e . pip install -r requirements-dev.txt # Run tests pytest --cov=src tests/

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

See CREDITS.md for detailed attribution of all dependencies and third-party code.

📮 Support

🚦 Status

  • Core Search: Production ready
  • Code Analysis: Production ready
  • Git Integration: Production ready
  • Voice Assistant: Beta
  • 🚧 Cloud Deployment: In development

🎉 What's New

Version 1.0.0

  • 🎙️ Voice Assistant with web UI
  • 📸 Media history for screenshots and recordings
  • 🧠 Model information tools
  • 📊 Enhanced code metrics
  • 🔄 Improved orchestration framework
  • 🚀 Performance optimizations

See CHANGELOG.md for full release notes.


Built with ❤️ for Claude Code and AI assisted developement

⬆ Back to top

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables semantic code search across projects using AI embeddings to find code by meaning rather than just text matching. Provides fast intelligent search, symbol analysis, and code similarity detection with multi-language support.

  1. 🌟 Overview
    1. Note from author
      1. Key Capabilities
    2. 🎯 Features
      1. Core Search Capabilities
      2. Code Intelligence Tools
      3. Voice Assistant Integration
      4. Orchestration Framework
    3. 🚀 Installation
      1. Quick Start
      2. Claude Desktop Configuration
    4. 🎙️ Voice Assistant
      1. Setup
      2. Access the Web UI
      3. VS Code Extension
      4. Voice Commands Examples
    5. 📚 Usage Examples
      1. In Claude Desktop
      2. Available Tools
    6. 🏗️ Architecture
      1. 🔧 Configuration
        1. 📊 Performance
          1. 🧪 Testing
            1. 🤝 Contributing
              1. Development Setup
            2. 📄 License
              1. 🙏 Acknowledgments
                1. 📮 Support
                  1. 🚦 Status
                    1. 🎉 What's New
                      1. Version 1.0.0

                    Related MCP Servers

                    • -
                      security
                      F
                      license
                      -
                      quality
                      A local server that provides powerful code analysis and search capabilities for software projects, helping AI assistants and development tools understand codebases for tasks like code generation and refactoring.
                      Last updated -
                      3
                      • Apple
                      • Linux
                    • -
                      security
                      F
                      license
                      -
                      quality
                      HTTP-based server that provides semantic code search capabilities to IDEs through the Model Context Protocol, allowing efficient codebase exploration without repeated indexing.
                      Last updated -
                      2
                      73
                      • Apple
                      • Linux
                    • -
                      security
                      A
                      license
                      -
                      quality
                      Enables semantic code search across codebases using Qdrant vector database and OpenAI embeddings, allowing users to find code by meaning rather than just keywords through natural language queries.
                      Last updated -
                      MIT License
                    • -
                      security
                      A
                      license
                      -
                      quality
                      An intelligent server that provides semantic code search, domain-driven analysis, and advanced code understanding for large codebases using LLMs and vector embeddings.
                      Last updated -
                      4
                      MIT License

                    View all related MCP servers

                    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/stevenjjobson/scs-mcp'

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