mcp-local-rag

🥈Silver

Local-first RAG server for developers using MCP. Enables semantic and keyword search for code and technical docs. Fully private, zero setup. Ideal for operations teams needing secure, local search capabilities.

212190Updated Today

Intermediate30min to implementautomation

Saves ~150 min per use

Quick InstallView Source

git clone https://github.com/shinpr/mcp-local-rag.git

Works with:

Claude

Overview

About This Skill

How to Use

["Install the MCP server locally using the provided package manager command (e.g., `npm install @modelcontextprotocol/local-rag`).","Initialize the RAG index by running `mcp-local-rag --index /path/to/codebase` to scan your project files.","Use the prompt template above in your AI assistant (e.g., Claude/ChatGPT) by replacing [TOPIC] and [CRITERIA] with your specific query.","For advanced searches, include file path filters (e.g., `/src/api/**`) or line number constraints in [CRITERIA].","Refresh the index periodically with `mcp-local-rag --reindex` to keep results up-to-date. For large codebases, schedule this as a nightly task."]

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/shinpr/mcp-local-rag

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Use the local RAG server to search for [TOPIC] in the codebase or technical documentation. Focus on finding relevant snippets, functions, or concepts that match [CRITERIA]. Provide the results in a structured format with file paths, line numbers, and a brief explanation of relevance. Example: 'Search for 'authentication middleware' in the /src/api directory and highlight functions that handle JWT validation.'

Example Output

```
**Search Results for 'authentication middleware' in /src/api/**

1. **File**: /src/api/middleware/auth.js
   **Line**: 42-67
   **Snippet**:
   ```javascript
   const jwt = require('jsonwebtoken');
   
   const authenticateToken = (req, res, next) => {
     const token = req.headers['authorization']?.split(' ')[1];
     if (!token) return res.sendStatus(401);
     
     jwt.verify(token, process.env.JWT_SECRET, (err, user) => {
       if (err) return res.sendStatus(403);
       req.user = user;
       next();
     });
   };
   ```
   **Relevance**: Implements JWT-based authentication middleware used in 85% of API routes.

2. **File**: /src/api/routes/userRoutes.js
   **Line**: 12-18
   **Snippet**:
   ```javascript
   router.get('/profile', authenticateToken, async (req, res) => {
     const user = await User.findById(req.user.id);
     res.json(user);
   });
   ```
   **Relevance**: Demonstrates the middleware in action for protected routes.

**Total Matches**: 12 files found. Top 2 shown above.
```

*Generated using local RAG server (MCP) on 2024-05-20. Indexed files: 478, total tokens: 1,245,890.*