MCP Tools

The server exposes the following tools:

`index_repository`

Index code files from specified directories. This tool now queues an indexing task that runs asynchronously in the background, preventing timeouts for large repositories.

Parameters:

directories (List of strings): List of absolute paths to index
force_reindex (bool): Force re-indexing of all files

`search_code`

Search for code semantically similar to a query.

Parameters:

query (str): Search query
limit (int): Maximum results (default: 10)
min_relevance (float): Minimum relevance score (0.0-1.0)

`get_index_stats`

Get comprehensive statistics about the index and indexing queue.

`list_directory`

List contents of a directory to help identify what to index.

Parameters:

directory_path (str): Path to list

`register_project`

Register a new project for automatic file watching and indexing. The system uses intelligent content detection to identify code files, not just file extensions.

Parameters:

name (str): Project name
paths (List of strings): Directory paths to track
auto_index (bool): Whether to perform initial indexing (default: True)

`unregister_project`

Stop watching and unregister a project.

Parameters:

project_id (str): ID of the project to unregister

`list_projects`

List all registered projects with their current status.

Configuration

Environment Variables

BREEZE_DATA_ROOT: Directory for storing index data (default: ~/.breeze/data)
BREEZE_DB_NAME: Database name (default: code_index)
BREEZE_EMBEDDING_MODEL: Embedding model to use (default: ibm-granite/granite-embedding-125m-english)
BREEZE_EMBEDDING_API_KEY: API key for cloud embedding providers
BREEZE_HOST: Server host (default: 0.0.0.0)
BREEZE_PORT: Server port (default: 9483)
BREEZE_CONCURRENT_READERS: Concurrent file readers (default: 20)
BREEZE_CONCURRENT_EMBEDDERS: Concurrent embedders (default: 10)
BREEZE_CONCURRENT_WRITERS: Concurrent DB writers (default: 10)
BREEZE_VOYAGE_CONCURRENT_REQUESTS: Max concurrent Voyage AI requests (default: 5)

MCP Configuration Examples

VS Code

{
  "mcp.servers": {
    "breeze": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/casualjim/breeze.git", "python", "-m", "breeze", "serve"],
      "env": {
        "BREEZE_DATA_ROOT": "${workspaceFolder}/.breeze"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "breeze": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/casualjim/breeze.git", "breeze", "serve"]
    }
  }
}

Testing

Run the test script to verify functionality:

uv run python test_breeze.py

Important: Concurrency Limitations

⚠️ LanceDB (the vector database used by Breeze) does not support concurrent writes from multiple proces

Categories

Current Category: code-search

breeze

exa-server

tavily-server

mcp-server-tree-sitter