Ngao Search - MCP Server

Claude Desktop MCP Server for code search with file watching, REST API, and Model Context Protocol integration.

Note: This is the MCP server package for Claude Desktop integration. If you're looking for the core search library to embed in your own applications, see @ngao/search-core.

Features

• 🔍 Full-text and semantic code search
• 👁️ Automatic file watching and reindexing
• 🌐 REST API server
• 🔌 Model Context Protocol (MCP) integration
• 🖥️ Interactive CLI
• 📊 Session and search history management

Installation

npm install -g @ngao/search

Or use directly:

npx @ngao/search

Pre-downloaded Models

Embedding models are included with @ngao/search-core dependency.

The core library contains pre-downloaded models - no additional downloads needed!

See the Installation Guide for details.

Quick Start

Setup

npx @ngao/search --setup

This will guide you through setting up a search index for your project.

Search via CLI

npx @ngao/search search "function name"

Start REST API Server

npx @ngao/search --server --port 3000

Then use the API:

curl http://localhost:3000/api/search?q=useState

Start MCP Server

npx @ngao/search --mcp

Configuration

Create a config.json file in your project root:

{
  "projectRoot": "/path/to/project",
  "language": "typescript",
  "indexDirectory": ".ngao/index",
  "watchMode": true,
  "autoReindex": true
}

Documentation

• Installation Guide
• Usage Guide
• API Documentation
• MCP Integration
• File Watching

Architecture

This application is built on top of @ngao/search-core, providing additional features:

• File watching (Chokidar)
• HTTP REST API (Express)
• MCP protocol transport
• CLI interface
• Session management

License

Apache-2.0