Files-DB-MCP: Vector Search for Code Projects
2025.03.25
0
Python向量搜索代码项目本地数据库开发效率数据库
Files-DB-MCP 是一个本地向量数据库系统，专为LLM编码代理设计，通过消息控制协议（MCP）提供快速、高效的软件项目搜索能力。它具备零配置、实时监控、向量搜索等核心功能，适用于代码项目的语义搜索和开发效率提升。
View on GitHub
Overview
基本能力
产品定位
Files-DB-MCP 是一个本地向量数据库系统，旨在为LLM编码代理提供快速、高效的软件项目搜索能力。
核心功能
- 零配置 - 自动检测项目结构，提供合理的默认设置
- 实时监控 - 持续监控文件变化
- 向量搜索 - 提供语义搜索功能，帮助找到相关代码
- MCP接口 - 兼容Claude Code和其他LLM工具
- 开源模型 - 使用Hugging Face模型进行代码嵌入
适用场景
- 代码项目的语义搜索
- 开发效率提升
- LLM编码代理的本地数据库支持
工具列表
- Docker - 用于容器化部署
- Docker Compose - 用于多容器管理
- Hugging Face模型 - 用于代码嵌入
常见问题解答
- 首次启动慢：首次运行时会下载嵌入模型，可能需要几分钟时间。
- 模型缓存：模型存储在Docker卷
model_cache中，跨项目和重启容器时持久化。
使用教程
使用依赖
- Docker
- Docker Compose
安装教程
选项1：克隆并设置（推荐）
# 使用SSH（推荐如果已设置SSH密钥）
git clone [email protected]:randomm/files-db-mcp.git ~/.files-db-mcp && bash ~/.files-db-mcp/install/setup.sh
# 使用HTTPS（如果没有设置SSH密钥）
git clone https://github.com/randomm/files-db-mcp.git ~/.files-db-mcp && bash ~/.files-db-mcp/install/setup.sh
选项2：自动化安装脚本
curl -fsSL https://raw.githubusercontent.com/randomm/files-db-mcp/main/install/install.sh | bash
调试方式
安装完成后，在任何项目目录中运行：
files-db-mcp
服务将： 1. 检测项目文件 2. 在后台开始索引 3. 立即响应MCP搜索查询
首次启动
首次运行时，Files-DB-MCP将下载嵌入模型，可能需要几分钟时间。可以使用以下命令加速首次启动：
# 使用更小、更快的模型（90MB）
EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2 files-db-mcp
# 或启用快速启动模式
FAST_STARTUP=true files-db-mcp