Files-DB-MCP: Vector Search for Code Projects
A local vector database system that provides LLM coding agents with fast, efficient search capabilities for software projects via the Message Control Protocol (MCP).
Features
- Zero Configuration - Auto-detects project structure with sensible defaults
- Real-Time Monitoring - Continuously watches for file changes
- Vector Search - Semantic search for finding relevant code
- MCP Interface - Compatible with Claude Code and other LLM tools
- Open Source Models - Uses Hugging Face models for code embeddings
Installation
Option 1: Clone and Setup (Recommended)
# Using SSH (recommended if you have SSH keys set up with GitHub)
git clone git@github.com:randomm/files-db-mcp.git ~/.files-db-mcp && bash ~/.files-db-mcp/install/setup.sh
# Using HTTPS (if you don't have SSH keys set up)
git clone https://github.com/randomm/files-db-mcp.git ~/.files-db-mcp && bash ~/.files-db-mcp/install/setup.sh
Option 2: Automated Installation Script
curl -fsSL https://raw.githubusercontent.com/randomm/files-db-mcp/main/install/install.sh | bash
Usage
After installation, run in any project directory:
files-db-mcp
The service will:
- Detect your project files
- Start indexing in the background
- Begin responding to MCP search queries immediately
Requirements
- Docker
- Docker Compose
Configuration
Files-DB-MCP works without configuration, but you can customize it with environment variables:
EMBEDDING_MODEL- Change the embedding model (default: 'jinaai/jina-embeddings-v2-base-code' or project-specific model)FAST_STARTUP- Set to 'true' to use a smaller model for faster startup (default: 'false')QUANTIZATION- Enable/disable quantization (default: 'true')BINARY_EMBEDDINGS- Enable/disable binary embeddings (default: 'false')IGNORE_PATTERNS- Comma-separated list of files/dirs to ignore
First-Time Startup
On first run, Files-DB-MCP will download embedding models which may take several minutes depending on:
- The size of the selected model (300-500MB for high-quality models)
- Your internet connection speed
Subsequent startups will be much faster as models are cached in a persistent Docker volume. For faster initial startup, you can:
# Use a smaller, faster model (90MB)
EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2 files-db-mcp
# Or enable fast startup mode
FAST_STARTUP=true files-db-mcp
Model Caching
Files-DB-MCP automatically persists downloaded embedding models, so you only need to download them once:
- Models are stored in a Docker volume called
model_cache - This volume persists between container restarts and across different projects
- The cache is shared for all projects using Files-DB-MCP on your machine
- You don't need to download the model again for each project
Claude Code Integration
Add to your Claude Code configuration:
{
"mcpServers": {
"files-db-mcp": {
"command": "python",
"args": ["/path/to/src/claude_mcp_server.py", "--host", "localhost", "--port", "6333"]
}
}
}
For details, see Claude MCP Integration.
Documentation
- Installation Guide - Detailed setup instructions
- API Reference - Complete API documentation
- Configuration Guide - Configuration options
Repository Structure
/src- Source code/tests- Unit and integration tests/docs- Documentation/scripts- Utility scripts/install- Installation scripts/.docker- Docker configuration/config- Configuration files/ai-assist- AI assistance files
License
Contributing
Contributions welcome! Please feel free to submit a pull request.
Metadata
Release files for iflow-mcp_files-db-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_files_db_mcp-0.1.0.tar.gz | 160.4 kB | Without provenance | Details for iflow_mcp_files_db_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_files_db_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_files_db_mcp-0.1.0-py3-none-any.whl |
Total release size: 198.3 kB
Release files / iflow_mcp_files_db_mcp-0.1.0.tar.gz
| Download URL | iflow_mcp_files_db_mcp-0.1.0.tar.gz |
|---|---|
| Size | 160.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dd53447a404258eeaba431150453bff69cd50438b6a428834282f09cf289005e
|
|
BLAKE2b-256 checksum How to use checksums |
ad15fe221fb3a0b4e8c726913a61ecd11fe74903e8a5949207a86d76c704d994
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.6.9
|
Release files / iflow_mcp_files_db_mcp-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_files_db_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 37.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9fcc883f929ea6af4c0e5246c18f2304b851f8084c4f662f218c1b420f7942a1
|
|
BLAKE2b-256 checksum How to use checksums |
f3963fd6156dd53b83ac1da5ded1ddb170d2569890a9382213ad309a91ed9396
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.6.9
|
Security for iflow-mcp_files-db-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.