@le0zj/mcp-frontend-search

MCP Server for frontend code vector semantic search.

Index Vue / JS / TS projects into Qdrant vector database, then search with natural language queries using hybrid vector + BM25 search with RRF fusion.

Tools

| 工具 | 说明 | |------|------| | index_frontend | 初始化前端向量索引（解析 Vue/JS/TS，生成向量索引到 Qdrant） | | search_frontend | 自然语言搜索前端组件（向量 + BM25 混合搜索） |

Install

npm install -g @le0zj/mcp-frontend-search
# 或直接用 npx

快速开始

1. 前置依赖

• Qdrant 向量数据库（默认 localhost:6333）
• 智谱 Embedding API Key（申请地址）

docker run -d -p 6333:6333 qdrant/qdrant

2. 全局注册一次

claude mcp add frontend-search \
  -e EMBEDDING_API_KEY=your_key \
  -- npx @le0zj/mcp-frontend-search

3. 进到项目目录，启动 Claude Code

cd D:/code/admin-web
claude

4. 直接对话

> 初始化前端索引
> 搜索用户管理相关的组件
> 搜索频道列表页面

索引隔离

Qdrant 中的索引按 project 字段（目录名）隔离，不同项目互不影响：

D:/code/admin-web/      → project: "admin-web"     ← 独立索引
D:/code/mobile-app/     → project: "mobile-app"    ← 独立索引

Environment Variables

| 变量 | 必须 | 说明 | |------|------|------| | EMBEDDING_API_KEY | ✅ | 智谱 Embedding API Key |

Requirements

• Node.js >= 18
• Qdrant vector database
• Zhipu (智谱) Embedding API key

License

MIT