mcp-vector-search


Namemcp-vector-search JSON
Version 0.12.6 PyPI version JSON
download
home_pageNone
SummaryCLI-first semantic code search with MCP integration
upload_time2025-11-03 17:15:34
maintainerNone
docs_urlNone
authorNone
requires_python>=3.11
licenseMIT License Copyright (c) 2024 Robert Matsuoka Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords code-search mcp semantic-search vector-database
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            # MCP Vector Search

🔍 **CLI-first semantic code search with MCP integration**

[![PyPI version](https://badge.fury.io/py/mcp-vector-search.svg)](https://badge.fury.io/py/mcp-vector-search)
[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

> ⚠️ **Alpha Release (v0.7.1)**: This is an early-stage project under active development. Expect breaking changes and rough edges. Feedback and contributions are welcome!

A modern, fast, and intelligent code search tool that understands your codebase through semantic analysis and AST parsing. Built with Python, powered by ChromaDB, and designed for developer productivity.

## ✨ Features

### 🚀 **Core Capabilities**
- **Semantic Search**: Find code by meaning, not just keywords
- **AST-Aware Parsing**: Understands code structure (functions, classes, methods)
- **Multi-Language Support**: 8 languages - Python, JavaScript, TypeScript, Dart/Flutter, PHP, Ruby, HTML, and Markdown/Text (with extensible architecture)
- **Real-time Indexing**: File watching with automatic index updates
- **Automatic Version Tracking**: Smart reindexing on tool upgrades
- **Local-First**: Complete privacy with on-device processing
- **Zero Configuration**: Auto-detects project structure and languages

### 🛠️ **Developer Experience**
- **CLI-First Design**: Simple commands for immediate productivity
- **Rich Output**: Syntax highlighting, similarity scores, context
- **Fast Performance**: Sub-second search responses, efficient indexing
- **Modern Architecture**: Async-first, type-safe, modular design
- **Semi-Automatic Reindexing**: Multiple strategies without daemon processes

### 🔧 **Technical Features**
- **Vector Database**: ChromaDB with connection pooling for 13.6% performance boost
- **Embedding Models**: Configurable sentence transformers
- **Smart Reindexing**: Search-triggered, Git hooks, scheduled tasks, and manual options
- **Extensible Parsers**: Plugin architecture for new languages
- **Configuration Management**: Project-specific settings
- **Production Ready**: Connection pooling, auto-indexing, comprehensive error handling

## 🚀 Quick Start

### Installation

```bash
# Install from PyPI
pip install mcp-vector-search

# Or with UV (recommended)
uv add mcp-vector-search

# Or install from source
git clone https://github.com/bobmatnyc/mcp-vector-search.git
cd mcp-vector-search
uv sync && uv pip install -e .
```

### Complete Setup (One Command)

The **hierarchical install command** (v0.13.0) provides complete project setup and MCP integration management:

```bash
# Quick setup (recommended)
mcp-vector-search install

# This will:
# 1. Initialize your project configuration
# 2. Automatically index your codebase
# 3. Provide next-step hints for MCP integration

# Install with all MCP integrations at once
mcp-vector-search install --with-mcp

# Custom file extensions
mcp-vector-search install --extensions .py,.js,.ts,.dart

# Skip automatic indexing
mcp-vector-search install --no-auto-index
```

### Add MCP Integration for AI Tools

```bash
# Add Claude Code integration (project-scoped)
mcp-vector-search install claude-code

# Add Cursor IDE integration (global)
mcp-vector-search install cursor

# Add Claude Desktop integration (global)
mcp-vector-search install claude-desktop

# See all available platforms
mcp-vector-search install list
```

### Remove MCP Integrations

```bash
# Remove specific platform
mcp-vector-search uninstall claude-code

# Remove all integrations
mcp-vector-search uninstall --all

# List configured integrations
mcp-vector-search uninstall list
```

### Basic Usage

```bash
# Search your code
mcp-vector-search search "authentication logic"
mcp-vector-search search "database connection setup"
mcp-vector-search search "error handling patterns"

# Index your codebase (if not done during install)
mcp-vector-search index

# Check project status
mcp-vector-search status

# Start file watching (auto-update index)
mcp-vector-search watch
```

### Smart CLI with "Did You Mean" Suggestions

The CLI includes intelligent command suggestions for typos:

```bash
# Typos are automatically detected and corrected
$ mcp-vector-search serach "auth"
No such command 'serach'. Did you mean 'search'?

$ mcp-vector-search indx
No such command 'indx'. Did you mean 'index'?
```

See [docs/CLI_FEATURES.md](docs/CLI_FEATURES.md) for more details.

## Versioning & Releasing

This project uses semantic versioning with an automated release workflow.

### Quick Commands
- `make version-show` - Display current version
- `make release-patch` - Create patch release
- `make publish` - Publish to PyPI

See [docs/VERSIONING_WORKFLOW.md](docs/VERSIONING_WORKFLOW.md) for complete documentation.

## 📖 Documentation

### Commands

#### `install` - Install Project and MCP Integrations (v0.13.0)
```bash
# Quick setup (recommended)
mcp-vector-search install

# Install with all MCP integrations
mcp-vector-search install --with-mcp

# Custom file extensions
mcp-vector-search install --extensions .py,.js,.ts

# Skip automatic indexing
mcp-vector-search install --no-auto-index

# Platform-specific MCP integration
mcp-vector-search install claude-code      # Project-scoped
mcp-vector-search install claude-desktop   # Global
mcp-vector-search install cursor           # Global
mcp-vector-search install windsurf         # Global
mcp-vector-search install vscode           # Global

# List available platforms
mcp-vector-search install list
```

#### `uninstall` - Remove MCP Integrations (v0.13.0)
```bash
# Remove specific platform
mcp-vector-search uninstall claude-code

# Remove all integrations
mcp-vector-search uninstall --all

# List configured integrations
mcp-vector-search uninstall list

# Skip backup creation
mcp-vector-search uninstall claude-code --no-backup

# Alias (same as uninstall)
mcp-vector-search remove claude-code
```

#### `init` - Initialize Project (Simple)
```bash
# Basic initialization
mcp-vector-search init

# Custom configuration
mcp-vector-search init --extensions .py,.js,.ts --embedding-model sentence-transformers/all-MiniLM-L6-v2

# Force re-initialization
mcp-vector-search init --force
```

#### `index` - Index Codebase
```bash
# Index all files
mcp-vector-search index

# Index specific directory
mcp-vector-search index /path/to/code

# Force re-indexing
mcp-vector-search index --force

# Reindex entire project
mcp-vector-search index reindex

# Reindex entire project (explicit)
mcp-vector-search index reindex --all

# Reindex entire project without confirmation
mcp-vector-search index reindex --force

# Reindex specific file
mcp-vector-search index reindex path/to/file.py
```

#### `search` - Semantic Search
```bash
# Basic search
mcp-vector-search search "function that handles user authentication"

# Adjust similarity threshold
mcp-vector-search search "database queries" --threshold 0.7

# Limit results
mcp-vector-search search "error handling" --limit 10

# Search in specific context
mcp-vector-search search similar "path/to/function.py:25"
```

#### `auto-index` - Automatic Reindexing
```bash
# Setup all auto-indexing strategies
mcp-vector-search auto-index setup --method all

# Setup specific strategies
mcp-vector-search auto-index setup --method git-hooks
mcp-vector-search auto-index setup --method scheduled --interval 60

# Check for stale files and auto-reindex
mcp-vector-search auto-index check --auto-reindex --max-files 10

# View auto-indexing status
mcp-vector-search auto-index status

# Remove auto-indexing setup
mcp-vector-search auto-index teardown --method all
```

#### `watch` - File Watching
```bash
# Start watching for changes
mcp-vector-search watch

# Check watch status
mcp-vector-search watch status

# Enable/disable watching
mcp-vector-search watch enable
mcp-vector-search watch disable
```

#### `status` - Project Information
```bash
# Basic status
mcp-vector-search status

# Detailed information
mcp-vector-search status --verbose
```

#### `config` - Configuration Management
```bash
# View configuration
mcp-vector-search config show

# Update settings
mcp-vector-search config set similarity_threshold 0.8
mcp-vector-search config set embedding_model microsoft/codebert-base

# Configure indexing behavior
mcp-vector-search config set skip_dotfiles true    # Skip dotfiles (default)
mcp-vector-search config set respect_gitignore true # Respect .gitignore (default)

# Get specific setting
mcp-vector-search config get skip_dotfiles
mcp-vector-search config get respect_gitignore

# List available models
mcp-vector-search config models

# List all configuration keys
mcp-vector-search config list-keys
```

## 🚀 Performance Features

### Connection Pooling
Automatic connection pooling provides **13.6% performance improvement** with zero configuration:

```python
# Automatically enabled for high-throughput scenarios
from mcp_vector_search.core.database import PooledChromaVectorDatabase

database = PooledChromaVectorDatabase(
    max_connections=10,    # Pool size
    min_connections=2,     # Warm connections
    max_idle_time=300.0,   # 5 minutes
)
```

### Semi-Automatic Reindexing
Multiple strategies to keep your index up-to-date without daemon processes:

1. **Search-Triggered**: Automatically checks for stale files during searches
2. **Git Hooks**: Triggers reindexing after commits, merges, checkouts
3. **Scheduled Tasks**: System-level cron jobs or Windows tasks
4. **Manual Checks**: On-demand via CLI commands
5. **Periodic Checker**: In-process periodic checks for long-running apps

```bash
# Setup all strategies
mcp-vector-search auto-index setup --method all

# Check status
mcp-vector-search auto-index status
```

### Configuration

Projects are configured via `.mcp-vector-search/config.json`:

```json
{
  "project_root": "/path/to/project",
  "file_extensions": [".py", ".js", ".ts"],
  "embedding_model": "sentence-transformers/all-MiniLM-L6-v2",
  "similarity_threshold": 0.75,
  "languages": ["python", "javascript", "typescript"],
  "watch_files": true,
  "cache_embeddings": true,
  "skip_dotfiles": true,
  "respect_gitignore": true
}
```

#### Indexing Configuration Options

**`skip_dotfiles`** (default: `true`)
- Controls whether files and directories starting with "." are skipped during indexing
- **Whitelisted directories** are always indexed regardless of this setting:
  - `.github/` - GitHub workflows and actions
  - `.gitlab-ci/` - GitLab CI configuration
  - `.circleci/` - CircleCI configuration
- When `false`: All dotfiles are indexed (subject to gitignore rules if `respect_gitignore` is `true`)

**`respect_gitignore`** (default: `true`)
- Controls whether `.gitignore` patterns are respected during indexing
- When `false`: Files in `.gitignore` are indexed (subject to `skip_dotfiles` if enabled)

#### Configuration Use Cases

**Default Behavior** (Recommended for most projects):
```bash
# Skip dotfiles AND respect .gitignore
mcp-vector-search config set skip_dotfiles true
mcp-vector-search config set respect_gitignore true
```

**Index Everything** (Useful for deep code analysis):
```bash
# Index all files including dotfiles and gitignored files
mcp-vector-search config set skip_dotfiles false
mcp-vector-search config set respect_gitignore false
```

**Index Dotfiles but Respect .gitignore**:
```bash
# Index configuration files but skip build artifacts
mcp-vector-search config set skip_dotfiles false
mcp-vector-search config set respect_gitignore true
```

**Skip Dotfiles but Ignore .gitignore**:
```bash
# Useful when you want to index files in .gitignore but skip hidden config files
mcp-vector-search config set skip_dotfiles true
mcp-vector-search config set respect_gitignore false
```

## 🏗️ Architecture

### Core Components

- **Parser Registry**: Extensible system for language-specific parsing
- **Semantic Indexer**: Efficient code chunking and embedding generation
- **Vector Database**: ChromaDB integration for similarity search
- **File Watcher**: Real-time monitoring and incremental updates
- **CLI Interface**: Rich, user-friendly command-line experience

### Supported Languages

MCP Vector Search supports **8 programming languages** with full semantic search capabilities:

| Language   | Extensions | Status | Features |
|------------|------------|--------|----------|
| Python     | `.py`, `.pyw` | ✅ Full | Functions, classes, methods, docstrings |
| JavaScript | `.js`, `.jsx`, `.mjs` | ✅ Full | Functions, classes, JSDoc, ES6+ syntax |
| TypeScript | `.ts`, `.tsx` | ✅ Full | Interfaces, types, generics, decorators |
| Dart       | `.dart` | ✅ Full | Functions, classes, widgets, async, dartdoc |
| PHP        | `.php`, `.phtml` | ✅ Full | Classes, methods, traits, PHPDoc, Laravel patterns |
| Ruby       | `.rb`, `.rake`, `.gemspec` | ✅ Full | Modules, classes, methods, RDoc, Rails patterns |
| HTML       | `.html`, `.htm` | ✅ Full | Semantic content extraction, heading hierarchy, text chunking |
| Text/Markdown | `.txt`, `.md`, `.markdown` | ✅ Basic | Semantic chunking for documentation |

**Planned Languages:**
| Language   | Status | Features |
|------------|--------|----------|
| Java       | 🔄 Planned | Classes, methods, annotations |
| Go         | 🔄 Planned | Functions, structs, interfaces |
| Rust       | 🔄 Planned | Functions, structs, traits |

#### New Language Support

**HTML Support** (Unreleased):
- **Semantic Extraction**: Content from h1-h6, p, section, article, main, aside, nav, header, footer
- **Intelligent Chunking**: Based on heading hierarchy (h1-h6)
- **Context Preservation**: Maintains class and id attributes for searchability
- **Script/Style Filtering**: Ignores non-content elements
- **Use Cases**: Static sites, documentation, web templates, HTML fragments

**Dart/Flutter Support** (v0.4.15):
- **Widget Detection**: StatelessWidget, StatefulWidget recognition
- **State Classes**: Automatic parsing of `_WidgetNameState` patterns
- **Async Support**: Future<T> and async function handling
- **Dartdoc**: Triple-slash comment extraction
- **Tree-sitter AST**: Fast, accurate parsing with regex fallback

**PHP Support** (v0.5.0):
- **Class Detection**: Classes, interfaces, traits
- **Method Extraction**: Public, private, protected, static methods
- **Magic Methods**: __construct, __get, __set, __call, etc.
- **PHPDoc**: Full comment extraction
- **Laravel Patterns**: Controllers, Models, Eloquent support
- **Tree-sitter AST**: Fast parsing with regex fallback

**Ruby Support** (v0.5.0):
- **Module/Class Detection**: Full namespace support (::)
- **Method Extraction**: Instance and class methods
- **Special Syntax**: Method names with ?, ! support
- **Attribute Macros**: attr_accessor, attr_reader, attr_writer
- **RDoc**: Comment extraction (# and =begin...=end)
- **Rails Patterns**: ActiveRecord, Controllers support
- **Tree-sitter AST**: Fast parsing with regex fallback

## 🤝 Contributing

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

### Development Setup

```bash
# Clone the repository
git clone https://github.com/bobmatnyc/mcp-vector-search.git
cd mcp-vector-search

# Install dependencies with UV
uv sync

# Install in development mode
uv pip install -e .

# Test CLI from source (recommended during development)
./dev-mcp version        # Shows [DEV] indicator
./dev-mcp search "test"  # No reinstall needed after code changes

# Run tests
uv run pytest

# Run linting
uv run ruff check
uv run mypy src/
```

For detailed development workflow and `dev-mcp` usage, see the [Development](#-development) section below.

### Adding Language Support

1. Create a new parser in `src/mcp_vector_search/parsers/`
2. Extend the `BaseParser` class
3. Register the parser in `parsers/registry.py`
4. Add tests and documentation

## 📊 Performance

- **Indexing Speed**: ~1000 files/minute (typical Python project)
- **Search Latency**: <100ms for most queries
- **Memory Usage**: ~50MB baseline + ~1MB per 1000 code chunks
- **Storage**: ~1KB per code chunk (compressed embeddings)

## ⚠️ Known Limitations (Alpha)

- **Tree-sitter Integration**: Currently using regex fallback parsing (Tree-sitter setup needs improvement)
- **Search Relevance**: Embedding model may need tuning for code-specific queries
- **Error Handling**: Some edge cases may not be gracefully handled
- **Documentation**: API documentation is minimal
- **Testing**: Limited test coverage, needs real-world validation

## 🙏 Feedback Needed

We're actively seeking feedback on:

- **Search Quality**: How relevant are the search results for your codebase?
- **Performance**: How does indexing and search speed feel in practice?
- **Usability**: Is the CLI interface intuitive and helpful?
- **Language Support**: Which languages would you like to see added next?
- **Features**: What functionality is missing for your workflow?

Please [open an issue](https://github.com/bobmatnyc/mcp-vector-search/issues) or start a [discussion](https://github.com/bobmatnyc/mcp-vector-search/discussions) to share your experience!

## 🔮 Roadmap

### v0.0.x: Alpha (Current) 🔄
- [x] Core CLI interface
- [x] Python/JS/TS parsing
- [x] ChromaDB integration
- [x] File watching
- [x] Basic search functionality
- [ ] Real-world testing and feedback
- [ ] Bug fixes and stability improvements
- [ ] Performance optimizations

### v0.1.x: Beta 🔮
- [ ] Advanced search modes (contextual, similar code)
- [ ] Additional language support (Java, Go, Rust)
- [ ] Configuration improvements
- [ ] Comprehensive testing suite
- [ ] Documentation improvements

### v1.0.x: Stable 🔮
- [ ] MCP server implementation
- [ ] IDE extensions (VS Code, JetBrains)
- [ ] Git integration
- [ ] Team collaboration features
- [ ] Production-ready performance

## 🛠️ Development

### Three-Stage Development Workflow

**Stage A: Local Development & Testing**
```bash
# Setup development environment
uv sync && uv pip install -e .

# Run development tests
./scripts/dev-test.sh

# Run CLI from source (recommended during development)
./dev-mcp version        # Visual [DEV] indicator
./dev-mcp status         # Any command works
./dev-mcp search "auth"  # Immediate feedback on changes

# Alternative: use uv run directly
uv run mcp-vector-search version
```

#### Using the `dev-mcp` Development Helper

The `./dev-mcp` script provides a streamlined way to run the CLI from source code during development, eliminating the need for repeated installations.

**Key Features:**
- **Visual [DEV] Indicator**: Shows `[DEV]` prefix to distinguish from installed version
- **No Reinstall Required**: Reflects code changes immediately
- **Complete Argument Forwarding**: Works with all CLI commands and options
- **Verbose Mode**: Debug output with `--verbose` flag
- **Built-in Help**: Script usage with `--help`

**Usage Examples:**
```bash
# Basic commands (note the [DEV] prefix in output)
./dev-mcp version
./dev-mcp status
./dev-mcp index
./dev-mcp search "authentication logic"

# With CLI options
./dev-mcp search "error handling" --limit 10
./dev-mcp index --force

# Script verbose mode (shows Python interpreter, paths)
./dev-mcp --verbose search "database"

# Script help (shows dev-mcp usage, not CLI help)
./dev-mcp --help

# CLI command help (forwards --help to the CLI)
./dev-mcp search --help
./dev-mcp index --help
```

**When to Use:**
- **`./dev-mcp`** → Development workflow (runs from source code)
- **`mcp-vector-search`** → Production usage (runs installed version via pipx/pip)

**Benefits:**
- **Instant Feedback**: Changes to source code are reflected immediately
- **No Build Step**: Skip the reinstall cycle during active development
- **Clear Context**: Visual `[DEV]` indicator prevents confusion about which version is running
- **Error Handling**: Built-in checks for uv installation and project structure

**Requirements:**
- Must have `uv` installed (`pip install uv`)
- Must run from project root directory
- Requires `pyproject.toml` in current directory

**Stage B: Local Deployment Testing**
```bash
# Build and test clean deployment
./scripts/deploy-test.sh

# Test on other projects
cd ~/other-project
mcp-vector-search init && mcp-vector-search index
```

**Stage C: PyPI Publication**
```bash
# Publish to PyPI
./scripts/publish.sh

# Verify published version
pip install mcp-vector-search --upgrade
```

### Quick Reference
```bash
./scripts/workflow.sh  # Show workflow overview
```

See [DEVELOPMENT.md](DEVELOPMENT.md) for detailed development instructions.

## 📚 Documentation

For comprehensive documentation, see **[CLAUDE.md](CLAUDE.md)** - the main documentation index.

### Quick Links
- **[Configuration Guide](docs/CONFIGURATION.md)** - Comprehensive configuration reference
- **[Installation & Deployment](docs/DEPLOY.md)** - Setup and deployment guide
- **[CLI Features](docs/CLI_FEATURES.md)** - Advanced CLI features and usage
- **[Project Structure](docs/STRUCTURE.md)** - Architecture and file organization
- **[Contributing Guidelines](docs/developer/CONTRIBUTING.md)** - How to contribute
- **[API Reference](docs/developer/API.md)** - Internal API documentation
- **[Testing Guide](docs/developer/TESTING.md)** - Testing strategies
- **[Code Quality](docs/developer/LINTING.md)** - Linting and formatting
- **[Versioning](docs/VERSIONING.md)** - Version management
- **[Releases](docs/RELEASES.md)** - Release process

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

## 📄 License

MIT License - see [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

- [ChromaDB](https://github.com/chroma-core/chroma) for vector database
- [Tree-sitter](https://tree-sitter.github.io/) for parsing infrastructure
- [Sentence Transformers](https://www.sbert.net/) for embeddings
- [Typer](https://typer.tiangolo.com/) for CLI framework
- [Rich](https://rich.readthedocs.io/) for beautiful terminal output

---

**Built with ❤️ for developers who love efficient code search**

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "mcp-vector-search",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": null,
    "keywords": "code-search, mcp, semantic-search, vector-database",
    "author": null,
    "author_email": "Robert Matsuoka <bobmatnyc@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/01/a7/637271d95759873136425f170fe8eff9b20f97c785c8c691fd6a64ca5d25/mcp_vector_search-0.12.6.tar.gz",
    "platform": null,
    "description": "# MCP Vector Search\n\n\ud83d\udd0d **CLI-first semantic code search with MCP integration**\n\n[![PyPI version](https://badge.fury.io/py/mcp-vector-search.svg)](https://badge.fury.io/py/mcp-vector-search)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n> \u26a0\ufe0f **Alpha Release (v0.7.1)**: This is an early-stage project under active development. Expect breaking changes and rough edges. Feedback and contributions are welcome!\n\nA modern, fast, and intelligent code search tool that understands your codebase through semantic analysis and AST parsing. Built with Python, powered by ChromaDB, and designed for developer productivity.\n\n## \u2728 Features\n\n### \ud83d\ude80 **Core Capabilities**\n- **Semantic Search**: Find code by meaning, not just keywords\n- **AST-Aware Parsing**: Understands code structure (functions, classes, methods)\n- **Multi-Language Support**: 8 languages - Python, JavaScript, TypeScript, Dart/Flutter, PHP, Ruby, HTML, and Markdown/Text (with extensible architecture)\n- **Real-time Indexing**: File watching with automatic index updates\n- **Automatic Version Tracking**: Smart reindexing on tool upgrades\n- **Local-First**: Complete privacy with on-device processing\n- **Zero Configuration**: Auto-detects project structure and languages\n\n### \ud83d\udee0\ufe0f **Developer Experience**\n- **CLI-First Design**: Simple commands for immediate productivity\n- **Rich Output**: Syntax highlighting, similarity scores, context\n- **Fast Performance**: Sub-second search responses, efficient indexing\n- **Modern Architecture**: Async-first, type-safe, modular design\n- **Semi-Automatic Reindexing**: Multiple strategies without daemon processes\n\n### \ud83d\udd27 **Technical Features**\n- **Vector Database**: ChromaDB with connection pooling for 13.6% performance boost\n- **Embedding Models**: Configurable sentence transformers\n- **Smart Reindexing**: Search-triggered, Git hooks, scheduled tasks, and manual options\n- **Extensible Parsers**: Plugin architecture for new languages\n- **Configuration Management**: Project-specific settings\n- **Production Ready**: Connection pooling, auto-indexing, comprehensive error handling\n\n## \ud83d\ude80 Quick Start\n\n### Installation\n\n```bash\n# Install from PyPI\npip install mcp-vector-search\n\n# Or with UV (recommended)\nuv add mcp-vector-search\n\n# Or install from source\ngit clone https://github.com/bobmatnyc/mcp-vector-search.git\ncd mcp-vector-search\nuv sync && uv pip install -e .\n```\n\n### Complete Setup (One Command)\n\nThe **hierarchical install command** (v0.13.0) provides complete project setup and MCP integration management:\n\n```bash\n# Quick setup (recommended)\nmcp-vector-search install\n\n# This will:\n# 1. Initialize your project configuration\n# 2. Automatically index your codebase\n# 3. Provide next-step hints for MCP integration\n\n# Install with all MCP integrations at once\nmcp-vector-search install --with-mcp\n\n# Custom file extensions\nmcp-vector-search install --extensions .py,.js,.ts,.dart\n\n# Skip automatic indexing\nmcp-vector-search install --no-auto-index\n```\n\n### Add MCP Integration for AI Tools\n\n```bash\n# Add Claude Code integration (project-scoped)\nmcp-vector-search install claude-code\n\n# Add Cursor IDE integration (global)\nmcp-vector-search install cursor\n\n# Add Claude Desktop integration (global)\nmcp-vector-search install claude-desktop\n\n# See all available platforms\nmcp-vector-search install list\n```\n\n### Remove MCP Integrations\n\n```bash\n# Remove specific platform\nmcp-vector-search uninstall claude-code\n\n# Remove all integrations\nmcp-vector-search uninstall --all\n\n# List configured integrations\nmcp-vector-search uninstall list\n```\n\n### Basic Usage\n\n```bash\n# Search your code\nmcp-vector-search search \"authentication logic\"\nmcp-vector-search search \"database connection setup\"\nmcp-vector-search search \"error handling patterns\"\n\n# Index your codebase (if not done during install)\nmcp-vector-search index\n\n# Check project status\nmcp-vector-search status\n\n# Start file watching (auto-update index)\nmcp-vector-search watch\n```\n\n### Smart CLI with \"Did You Mean\" Suggestions\n\nThe CLI includes intelligent command suggestions for typos:\n\n```bash\n# Typos are automatically detected and corrected\n$ mcp-vector-search serach \"auth\"\nNo such command 'serach'. Did you mean 'search'?\n\n$ mcp-vector-search indx\nNo such command 'indx'. Did you mean 'index'?\n```\n\nSee [docs/CLI_FEATURES.md](docs/CLI_FEATURES.md) for more details.\n\n## Versioning & Releasing\n\nThis project uses semantic versioning with an automated release workflow.\n\n### Quick Commands\n- `make version-show` - Display current version\n- `make release-patch` - Create patch release\n- `make publish` - Publish to PyPI\n\nSee [docs/VERSIONING_WORKFLOW.md](docs/VERSIONING_WORKFLOW.md) for complete documentation.\n\n## \ud83d\udcd6 Documentation\n\n### Commands\n\n#### `install` - Install Project and MCP Integrations (v0.13.0)\n```bash\n# Quick setup (recommended)\nmcp-vector-search install\n\n# Install with all MCP integrations\nmcp-vector-search install --with-mcp\n\n# Custom file extensions\nmcp-vector-search install --extensions .py,.js,.ts\n\n# Skip automatic indexing\nmcp-vector-search install --no-auto-index\n\n# Platform-specific MCP integration\nmcp-vector-search install claude-code      # Project-scoped\nmcp-vector-search install claude-desktop   # Global\nmcp-vector-search install cursor           # Global\nmcp-vector-search install windsurf         # Global\nmcp-vector-search install vscode           # Global\n\n# List available platforms\nmcp-vector-search install list\n```\n\n#### `uninstall` - Remove MCP Integrations (v0.13.0)\n```bash\n# Remove specific platform\nmcp-vector-search uninstall claude-code\n\n# Remove all integrations\nmcp-vector-search uninstall --all\n\n# List configured integrations\nmcp-vector-search uninstall list\n\n# Skip backup creation\nmcp-vector-search uninstall claude-code --no-backup\n\n# Alias (same as uninstall)\nmcp-vector-search remove claude-code\n```\n\n#### `init` - Initialize Project (Simple)\n```bash\n# Basic initialization\nmcp-vector-search init\n\n# Custom configuration\nmcp-vector-search init --extensions .py,.js,.ts --embedding-model sentence-transformers/all-MiniLM-L6-v2\n\n# Force re-initialization\nmcp-vector-search init --force\n```\n\n#### `index` - Index Codebase\n```bash\n# Index all files\nmcp-vector-search index\n\n# Index specific directory\nmcp-vector-search index /path/to/code\n\n# Force re-indexing\nmcp-vector-search index --force\n\n# Reindex entire project\nmcp-vector-search index reindex\n\n# Reindex entire project (explicit)\nmcp-vector-search index reindex --all\n\n# Reindex entire project without confirmation\nmcp-vector-search index reindex --force\n\n# Reindex specific file\nmcp-vector-search index reindex path/to/file.py\n```\n\n#### `search` - Semantic Search\n```bash\n# Basic search\nmcp-vector-search search \"function that handles user authentication\"\n\n# Adjust similarity threshold\nmcp-vector-search search \"database queries\" --threshold 0.7\n\n# Limit results\nmcp-vector-search search \"error handling\" --limit 10\n\n# Search in specific context\nmcp-vector-search search similar \"path/to/function.py:25\"\n```\n\n#### `auto-index` - Automatic Reindexing\n```bash\n# Setup all auto-indexing strategies\nmcp-vector-search auto-index setup --method all\n\n# Setup specific strategies\nmcp-vector-search auto-index setup --method git-hooks\nmcp-vector-search auto-index setup --method scheduled --interval 60\n\n# Check for stale files and auto-reindex\nmcp-vector-search auto-index check --auto-reindex --max-files 10\n\n# View auto-indexing status\nmcp-vector-search auto-index status\n\n# Remove auto-indexing setup\nmcp-vector-search auto-index teardown --method all\n```\n\n#### `watch` - File Watching\n```bash\n# Start watching for changes\nmcp-vector-search watch\n\n# Check watch status\nmcp-vector-search watch status\n\n# Enable/disable watching\nmcp-vector-search watch enable\nmcp-vector-search watch disable\n```\n\n#### `status` - Project Information\n```bash\n# Basic status\nmcp-vector-search status\n\n# Detailed information\nmcp-vector-search status --verbose\n```\n\n#### `config` - Configuration Management\n```bash\n# View configuration\nmcp-vector-search config show\n\n# Update settings\nmcp-vector-search config set similarity_threshold 0.8\nmcp-vector-search config set embedding_model microsoft/codebert-base\n\n# Configure indexing behavior\nmcp-vector-search config set skip_dotfiles true    # Skip dotfiles (default)\nmcp-vector-search config set respect_gitignore true # Respect .gitignore (default)\n\n# Get specific setting\nmcp-vector-search config get skip_dotfiles\nmcp-vector-search config get respect_gitignore\n\n# List available models\nmcp-vector-search config models\n\n# List all configuration keys\nmcp-vector-search config list-keys\n```\n\n## \ud83d\ude80 Performance Features\n\n### Connection Pooling\nAutomatic connection pooling provides **13.6% performance improvement** with zero configuration:\n\n```python\n# Automatically enabled for high-throughput scenarios\nfrom mcp_vector_search.core.database import PooledChromaVectorDatabase\n\ndatabase = PooledChromaVectorDatabase(\n    max_connections=10,    # Pool size\n    min_connections=2,     # Warm connections\n    max_idle_time=300.0,   # 5 minutes\n)\n```\n\n### Semi-Automatic Reindexing\nMultiple strategies to keep your index up-to-date without daemon processes:\n\n1. **Search-Triggered**: Automatically checks for stale files during searches\n2. **Git Hooks**: Triggers reindexing after commits, merges, checkouts\n3. **Scheduled Tasks**: System-level cron jobs or Windows tasks\n4. **Manual Checks**: On-demand via CLI commands\n5. **Periodic Checker**: In-process periodic checks for long-running apps\n\n```bash\n# Setup all strategies\nmcp-vector-search auto-index setup --method all\n\n# Check status\nmcp-vector-search auto-index status\n```\n\n### Configuration\n\nProjects are configured via `.mcp-vector-search/config.json`:\n\n```json\n{\n  \"project_root\": \"/path/to/project\",\n  \"file_extensions\": [\".py\", \".js\", \".ts\"],\n  \"embedding_model\": \"sentence-transformers/all-MiniLM-L6-v2\",\n  \"similarity_threshold\": 0.75,\n  \"languages\": [\"python\", \"javascript\", \"typescript\"],\n  \"watch_files\": true,\n  \"cache_embeddings\": true,\n  \"skip_dotfiles\": true,\n  \"respect_gitignore\": true\n}\n```\n\n#### Indexing Configuration Options\n\n**`skip_dotfiles`** (default: `true`)\n- Controls whether files and directories starting with \".\" are skipped during indexing\n- **Whitelisted directories** are always indexed regardless of this setting:\n  - `.github/` - GitHub workflows and actions\n  - `.gitlab-ci/` - GitLab CI configuration\n  - `.circleci/` - CircleCI configuration\n- When `false`: All dotfiles are indexed (subject to gitignore rules if `respect_gitignore` is `true`)\n\n**`respect_gitignore`** (default: `true`)\n- Controls whether `.gitignore` patterns are respected during indexing\n- When `false`: Files in `.gitignore` are indexed (subject to `skip_dotfiles` if enabled)\n\n#### Configuration Use Cases\n\n**Default Behavior** (Recommended for most projects):\n```bash\n# Skip dotfiles AND respect .gitignore\nmcp-vector-search config set skip_dotfiles true\nmcp-vector-search config set respect_gitignore true\n```\n\n**Index Everything** (Useful for deep code analysis):\n```bash\n# Index all files including dotfiles and gitignored files\nmcp-vector-search config set skip_dotfiles false\nmcp-vector-search config set respect_gitignore false\n```\n\n**Index Dotfiles but Respect .gitignore**:\n```bash\n# Index configuration files but skip build artifacts\nmcp-vector-search config set skip_dotfiles false\nmcp-vector-search config set respect_gitignore true\n```\n\n**Skip Dotfiles but Ignore .gitignore**:\n```bash\n# Useful when you want to index files in .gitignore but skip hidden config files\nmcp-vector-search config set skip_dotfiles true\nmcp-vector-search config set respect_gitignore false\n```\n\n## \ud83c\udfd7\ufe0f Architecture\n\n### Core Components\n\n- **Parser Registry**: Extensible system for language-specific parsing\n- **Semantic Indexer**: Efficient code chunking and embedding generation\n- **Vector Database**: ChromaDB integration for similarity search\n- **File Watcher**: Real-time monitoring and incremental updates\n- **CLI Interface**: Rich, user-friendly command-line experience\n\n### Supported Languages\n\nMCP Vector Search supports **8 programming languages** with full semantic search capabilities:\n\n| Language   | Extensions | Status | Features |\n|------------|------------|--------|----------|\n| Python     | `.py`, `.pyw` | \u2705 Full | Functions, classes, methods, docstrings |\n| JavaScript | `.js`, `.jsx`, `.mjs` | \u2705 Full | Functions, classes, JSDoc, ES6+ syntax |\n| TypeScript | `.ts`, `.tsx` | \u2705 Full | Interfaces, types, generics, decorators |\n| Dart       | `.dart` | \u2705 Full | Functions, classes, widgets, async, dartdoc |\n| PHP        | `.php`, `.phtml` | \u2705 Full | Classes, methods, traits, PHPDoc, Laravel patterns |\n| Ruby       | `.rb`, `.rake`, `.gemspec` | \u2705 Full | Modules, classes, methods, RDoc, Rails patterns |\n| HTML       | `.html`, `.htm` | \u2705 Full | Semantic content extraction, heading hierarchy, text chunking |\n| Text/Markdown | `.txt`, `.md`, `.markdown` | \u2705 Basic | Semantic chunking for documentation |\n\n**Planned Languages:**\n| Language   | Status | Features |\n|------------|--------|----------|\n| Java       | \ud83d\udd04 Planned | Classes, methods, annotations |\n| Go         | \ud83d\udd04 Planned | Functions, structs, interfaces |\n| Rust       | \ud83d\udd04 Planned | Functions, structs, traits |\n\n#### New Language Support\n\n**HTML Support** (Unreleased):\n- **Semantic Extraction**: Content from h1-h6, p, section, article, main, aside, nav, header, footer\n- **Intelligent Chunking**: Based on heading hierarchy (h1-h6)\n- **Context Preservation**: Maintains class and id attributes for searchability\n- **Script/Style Filtering**: Ignores non-content elements\n- **Use Cases**: Static sites, documentation, web templates, HTML fragments\n\n**Dart/Flutter Support** (v0.4.15):\n- **Widget Detection**: StatelessWidget, StatefulWidget recognition\n- **State Classes**: Automatic parsing of `_WidgetNameState` patterns\n- **Async Support**: Future<T> and async function handling\n- **Dartdoc**: Triple-slash comment extraction\n- **Tree-sitter AST**: Fast, accurate parsing with regex fallback\n\n**PHP Support** (v0.5.0):\n- **Class Detection**: Classes, interfaces, traits\n- **Method Extraction**: Public, private, protected, static methods\n- **Magic Methods**: __construct, __get, __set, __call, etc.\n- **PHPDoc**: Full comment extraction\n- **Laravel Patterns**: Controllers, Models, Eloquent support\n- **Tree-sitter AST**: Fast parsing with regex fallback\n\n**Ruby Support** (v0.5.0):\n- **Module/Class Detection**: Full namespace support (::)\n- **Method Extraction**: Instance and class methods\n- **Special Syntax**: Method names with ?, ! support\n- **Attribute Macros**: attr_accessor, attr_reader, attr_writer\n- **RDoc**: Comment extraction (# and =begin...=end)\n- **Rails Patterns**: ActiveRecord, Controllers support\n- **Tree-sitter AST**: Fast parsing with regex fallback\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n### Development Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/bobmatnyc/mcp-vector-search.git\ncd mcp-vector-search\n\n# Install dependencies with UV\nuv sync\n\n# Install in development mode\nuv pip install -e .\n\n# Test CLI from source (recommended during development)\n./dev-mcp version        # Shows [DEV] indicator\n./dev-mcp search \"test\"  # No reinstall needed after code changes\n\n# Run tests\nuv run pytest\n\n# Run linting\nuv run ruff check\nuv run mypy src/\n```\n\nFor detailed development workflow and `dev-mcp` usage, see the [Development](#-development) section below.\n\n### Adding Language Support\n\n1. Create a new parser in `src/mcp_vector_search/parsers/`\n2. Extend the `BaseParser` class\n3. Register the parser in `parsers/registry.py`\n4. Add tests and documentation\n\n## \ud83d\udcca Performance\n\n- **Indexing Speed**: ~1000 files/minute (typical Python project)\n- **Search Latency**: <100ms for most queries\n- **Memory Usage**: ~50MB baseline + ~1MB per 1000 code chunks\n- **Storage**: ~1KB per code chunk (compressed embeddings)\n\n## \u26a0\ufe0f Known Limitations (Alpha)\n\n- **Tree-sitter Integration**: Currently using regex fallback parsing (Tree-sitter setup needs improvement)\n- **Search Relevance**: Embedding model may need tuning for code-specific queries\n- **Error Handling**: Some edge cases may not be gracefully handled\n- **Documentation**: API documentation is minimal\n- **Testing**: Limited test coverage, needs real-world validation\n\n## \ud83d\ude4f Feedback Needed\n\nWe're actively seeking feedback on:\n\n- **Search Quality**: How relevant are the search results for your codebase?\n- **Performance**: How does indexing and search speed feel in practice?\n- **Usability**: Is the CLI interface intuitive and helpful?\n- **Language Support**: Which languages would you like to see added next?\n- **Features**: What functionality is missing for your workflow?\n\nPlease [open an issue](https://github.com/bobmatnyc/mcp-vector-search/issues) or start a [discussion](https://github.com/bobmatnyc/mcp-vector-search/discussions) to share your experience!\n\n## \ud83d\udd2e Roadmap\n\n### v0.0.x: Alpha (Current) \ud83d\udd04\n- [x] Core CLI interface\n- [x] Python/JS/TS parsing\n- [x] ChromaDB integration\n- [x] File watching\n- [x] Basic search functionality\n- [ ] Real-world testing and feedback\n- [ ] Bug fixes and stability improvements\n- [ ] Performance optimizations\n\n### v0.1.x: Beta \ud83d\udd2e\n- [ ] Advanced search modes (contextual, similar code)\n- [ ] Additional language support (Java, Go, Rust)\n- [ ] Configuration improvements\n- [ ] Comprehensive testing suite\n- [ ] Documentation improvements\n\n### v1.0.x: Stable \ud83d\udd2e\n- [ ] MCP server implementation\n- [ ] IDE extensions (VS Code, JetBrains)\n- [ ] Git integration\n- [ ] Team collaboration features\n- [ ] Production-ready performance\n\n## \ud83d\udee0\ufe0f Development\n\n### Three-Stage Development Workflow\n\n**Stage A: Local Development & Testing**\n```bash\n# Setup development environment\nuv sync && uv pip install -e .\n\n# Run development tests\n./scripts/dev-test.sh\n\n# Run CLI from source (recommended during development)\n./dev-mcp version        # Visual [DEV] indicator\n./dev-mcp status         # Any command works\n./dev-mcp search \"auth\"  # Immediate feedback on changes\n\n# Alternative: use uv run directly\nuv run mcp-vector-search version\n```\n\n#### Using the `dev-mcp` Development Helper\n\nThe `./dev-mcp` script provides a streamlined way to run the CLI from source code during development, eliminating the need for repeated installations.\n\n**Key Features:**\n- **Visual [DEV] Indicator**: Shows `[DEV]` prefix to distinguish from installed version\n- **No Reinstall Required**: Reflects code changes immediately\n- **Complete Argument Forwarding**: Works with all CLI commands and options\n- **Verbose Mode**: Debug output with `--verbose` flag\n- **Built-in Help**: Script usage with `--help`\n\n**Usage Examples:**\n```bash\n# Basic commands (note the [DEV] prefix in output)\n./dev-mcp version\n./dev-mcp status\n./dev-mcp index\n./dev-mcp search \"authentication logic\"\n\n# With CLI options\n./dev-mcp search \"error handling\" --limit 10\n./dev-mcp index --force\n\n# Script verbose mode (shows Python interpreter, paths)\n./dev-mcp --verbose search \"database\"\n\n# Script help (shows dev-mcp usage, not CLI help)\n./dev-mcp --help\n\n# CLI command help (forwards --help to the CLI)\n./dev-mcp search --help\n./dev-mcp index --help\n```\n\n**When to Use:**\n- **`./dev-mcp`** \u2192 Development workflow (runs from source code)\n- **`mcp-vector-search`** \u2192 Production usage (runs installed version via pipx/pip)\n\n**Benefits:**\n- **Instant Feedback**: Changes to source code are reflected immediately\n- **No Build Step**: Skip the reinstall cycle during active development\n- **Clear Context**: Visual `[DEV]` indicator prevents confusion about which version is running\n- **Error Handling**: Built-in checks for uv installation and project structure\n\n**Requirements:**\n- Must have `uv` installed (`pip install uv`)\n- Must run from project root directory\n- Requires `pyproject.toml` in current directory\n\n**Stage B: Local Deployment Testing**\n```bash\n# Build and test clean deployment\n./scripts/deploy-test.sh\n\n# Test on other projects\ncd ~/other-project\nmcp-vector-search init && mcp-vector-search index\n```\n\n**Stage C: PyPI Publication**\n```bash\n# Publish to PyPI\n./scripts/publish.sh\n\n# Verify published version\npip install mcp-vector-search --upgrade\n```\n\n### Quick Reference\n```bash\n./scripts/workflow.sh  # Show workflow overview\n```\n\nSee [DEVELOPMENT.md](DEVELOPMENT.md) for detailed development instructions.\n\n## \ud83d\udcda Documentation\n\nFor comprehensive documentation, see **[CLAUDE.md](CLAUDE.md)** - the main documentation index.\n\n### Quick Links\n- **[Configuration Guide](docs/CONFIGURATION.md)** - Comprehensive configuration reference\n- **[Installation & Deployment](docs/DEPLOY.md)** - Setup and deployment guide\n- **[CLI Features](docs/CLI_FEATURES.md)** - Advanced CLI features and usage\n- **[Project Structure](docs/STRUCTURE.md)** - Architecture and file organization\n- **[Contributing Guidelines](docs/developer/CONTRIBUTING.md)** - How to contribute\n- **[API Reference](docs/developer/API.md)** - Internal API documentation\n- **[Testing Guide](docs/developer/TESTING.md)** - Testing strategies\n- **[Code Quality](docs/developer/LINTING.md)** - Linting and formatting\n- **[Versioning](docs/VERSIONING.md)** - Version management\n- **[Releases](docs/RELEASES.md)** - Release process\n\n## \ud83e\udd1d Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n## \ud83d\udcc4 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## \ud83d\ude4f Acknowledgments\n\n- [ChromaDB](https://github.com/chroma-core/chroma) for vector database\n- [Tree-sitter](https://tree-sitter.github.io/) for parsing infrastructure\n- [Sentence Transformers](https://www.sbert.net/) for embeddings\n- [Typer](https://typer.tiangolo.com/) for CLI framework\n- [Rich](https://rich.readthedocs.io/) for beautiful terminal output\n\n---\n\n**Built with \u2764\ufe0f for developers who love efficient code search**\n",
    "bugtrack_url": null,
    "license": "MIT License\n        \n        Copyright (c) 2024 Robert Matsuoka\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.",
    "summary": "CLI-first semantic code search with MCP integration",
    "version": "0.12.6",
    "project_urls": {
        "Bug Tracker": "https://github.com/bobmatnyc/mcp-vector-search/issues",
        "Documentation": "https://mcp-vector-search.readthedocs.io",
        "Homepage": "https://github.com/bobmatnyc/mcp-vector-search",
        "Repository": "https://github.com/bobmatnyc/mcp-vector-search"
    },
    "split_keywords": [
        "code-search",
        " mcp",
        " semantic-search",
        " vector-database"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "3852f65b5f619da3e55d9660471c2959d2d74a204572a85db35d9ca8db0d44c2",
                "md5": "93773563b55bb86945ad138e8fa64e16",
                "sha256": "253599ed6d7c5eb05d4fc508ea5d6edb65121450d50db8a3e8987f4ae504c928"
            },
            "downloads": -1,
            "filename": "mcp_vector_search-0.12.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "93773563b55bb86945ad138e8fa64e16",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 214678,
            "upload_time": "2025-11-03T17:15:33",
            "upload_time_iso_8601": "2025-11-03T17:15:33.488216Z",
            "url": "https://files.pythonhosted.org/packages/38/52/f65b5f619da3e55d9660471c2959d2d74a204572a85db35d9ca8db0d44c2/mcp_vector_search-0.12.6-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "01a7637271d95759873136425f170fe8eff9b20f97c785c8c691fd6a64ca5d25",
                "md5": "684c5c03322a6304f2b544d67191336a",
                "sha256": "80a608ecd8463aabe9ceaa9e8532ba6f996fc40807ed5977fabbe3e5f37feade"
            },
            "downloads": -1,
            "filename": "mcp_vector_search-0.12.6.tar.gz",
            "has_sig": false,
            "md5_digest": "684c5c03322a6304f2b544d67191336a",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 561729,
            "upload_time": "2025-11-03T17:15:34",
            "upload_time_iso_8601": "2025-11-03T17:15:34.707975Z",
            "url": "https://files.pythonhosted.org/packages/01/a7/637271d95759873136425f170fe8eff9b20f97c785c8c691fd6a64ca5d25/mcp_vector_search-0.12.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-11-03 17:15:34",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "bobmatnyc",
    "github_project": "mcp-vector-search",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "mcp-vector-search"
}
None
Elapsed time: 3.12665s