Not in the top 1,000 by GitHub stars
shinpr/mcp-local-rag
Local-first RAG server for developers. Semantic + keyword search for code and technical docs. Works with MCP or CLI. Fully private, zero setup.
History
Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.
View weekly changes
skills/mcp-local-rag/SKILL.md
Week of Nov 2, 2026 · +0 / −0 lines
Before Instructions only → After Instructions only
d4f5bdd6253a → f74cbc232ef1
Week of Oct 26, 2026 · Line counts unavailable
Before Not checked yet → After Instructions only
First observation → d4f5bdd6253a
No earlier version was observed for comparison.
429GitHub stars
3stars in 7 days
1skill in this repository
63commits in 30 days
Heat
4.3- Star growth, last 7 daysNot available
- Star growth, last 24 hoursNot available
- Rank movement, last 7 daysNot available
- Commits, last 30 daysNot available
- Accounts asking about it through MCP, last 7 daysNot available
- Hot votes this weekNot available
Heat never changes the order by stars, and sponsorship never touches it. How heat works
Stars over time
30-day change not yet available: not enough history.
Individual skills in this repository
- mcp-local-rag
skills/mcp-local-rag
How it works
mcp-local-rag
When your agent uses it
Searches, saves, and maintains a local document index through a local RAG MCP server. Use when user says "search my docs", "save this page", "read around that chunk", "sync my index", or invokes `npx mcp-local-rag`.
What it loads into context
Frontmatter
64 tokensAlways available to the agent
SKILL.md
4,102 tokensWhen the skill is activated
Reference documents
3,417 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- Tools
- Workflow
- Search: Core Rules
- Context Expansion (read_chunk_neighbors)
- Ingestion
- Document Roots (Security Boundary)
- References
Files
SKILL.mdcore17,610 bytesSKILL.mdcore17,610 bytesSKILL.mdcore17,610 bytesSKILL.mdcore17,610 bytesSKILL.mdcore17,610 bytesSKILL.mdcore17,610 bytesSKILL.mdcore17,610 bytesSKILL.mdcore17,610 bytesreferences/cli-reference.mddoc12,064 bytesreferences/html-ingestion.mddoc2,022 bytes
Read SKILL.md
# MCP Local RAG Skills
## Tools
| MCP Tool | CLI Equivalent | Use When |
|----------|---------------|----------|
| `ingest_file` | `npx mcp-local-rag ingest <path> [--visual]` | Local files (PDF, DOCX, TXT, MD). CLI for bulk/directory. PDF visual mode: see [Visual content (PDFs)](#visual-content-pdfs). |
| `ingest_data` | — | Raw content (HTML, text) with source URL |
| `query_documents` | `npx mcp-local-rag query <text>` | Semantic + keyword hybrid search; optional `scope` to limit to a path prefix |
| `delete_file` | `npx mcp-local-rag delete <path>` | Remove ingested content |
| `list_files` | `npx mcp-local-rag list [--scope <prefix>]` | File ingestion status; optional `scope` to limit to a path prefix (reachable scan path) |
| `status` | `npx mcp-local-rag status` | Database stats |
| `read_chunk_neighbors` | `npx mcp-local-rag read-neighbors` | Read N chunks adjacent to a known chunkIndex (context expansion; call after `query_documents` or grep) |
| `sync_start` | `npx mcp-local-rag sync [path]` | Reconcile the index with disk after files changed outside this session. See [Index sync](#index-sync) |Skills included
- mcp-local-rag
Repository facts
- License
- MIT
- Created
- Oct 31, 2025
- Last pushed
- Nov 4, 2026
- Forks
- 84
- Open issues
- 1
- Project activity
- Active
Before you install
Instructions onlyAutomated signals, not a guarantee
Checked Nov 6, 2026
Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.
Show 7 notes
skills/mcp-local-rag/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/mcp-local-rag/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/mcp-local-rag/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/mcp-local-rag/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/mcp-local-rag/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/mcp-local-rag/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/mcp-local-rag/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzed
- No broad tool permissions
- No dangerous shell commands
- 15 network referencesin 2 files: mcp-local-rag/references/html-ingestion.md:23 mcp-local-rag/SKILL.md:120
- No hidden or obfuscated text
- No instruction overrides
- No executable scripts
- No access to secrets
- No requests to vote in Hot
Show all 15 signals by file
skills/mcp-local-rag/SKILL.md
- Network accessline 120
ingest_data({ content: "<html>...</html>", metadata: { source: "https://example.com/page", format: "html" } - Network accessline 121
content: "<html>...</html>", metadata: { source: "https://example.com/page", format: "html" } }) - Network accessline 122
metadata: { source: "https://example.com/page", format: "html" } - Network accessline 131
**Source format:** - Web page → Use URL: `https://example.com/page` - Network accessline 132
- Web page → Use URL: `https://example.com/page`
skills/mcp-local-rag/references/html-ingestion.md
- Network accessline 23
https://example.com/page?utm=x#section → https://example.com/page - Network accessline 28
ingest_data({ content: page1_html, metadata: { source: "https://example.com/results?page=1", format: "html" } - Network accessline 29
content: page1_html, metadata: { source: "https://example.com/results?page=1", format: "html" } }) - Network accessline 30
metadata: { source: "https://example.com/results?page=1", format: "html" } - Network accessline 59
ingest_data({ content: updated_html, metadata: { source: "https://example.com/page", format: "html" } - Network accessline 60
content: updated_html, metadata: { source: "https://example.com/page", format: "html" } }) - Network accessline 61
metadata: { source: "https://example.com/page", format: "html" } - Network accessline 69
{ "filePath": "/absolute/path/to/db/raw-data/<base64url-encoded-source>.md", "source": "https://example.com/page", - Network accessline 70
"filePath": "/absolute/path/to/db/raw-data/<base64url-encoded-source>.md", "source": "https://example.com/page", "fileTitle": "Getting Started Guide", - Network accessline 71
"source": "https://example.com/page",
How the signals fit together
Facts from a static read of the files at the pinned commit. They describe what the code does, not why.
Signal confidence: 15 facts
- Network access in code of the SKILL.mdmcp-local-rag/SKILL.md:120High confidence
- Network access in code of the SKILL.mdmcp-local-rag/SKILL.md:121High confidence
- Network access in code of the SKILL.mdmcp-local-rag/SKILL.md:122High confidence
- Network access in prose of the SKILL.mdmcp-local-rag/SKILL.md:131Low confidence
- Network access in prose of the SKILL.mdmcp-local-rag/SKILL.md:132Low confidence
- Network access in code of documentationmcp-local-rag/references/html-ingestion.md:23Low confidence
- Network access in code of documentationmcp-local-rag/references/html-ingestion.md:28Low confidence
- Network access in code of documentationmcp-local-rag/references/html-ingestion.md:29Low confidence
- Network access in code of documentationmcp-local-rag/references/html-ingestion.md:30Low confidence
- Network access in code of documentationmcp-local-rag/references/html-ingestion.md:59Low confidence
- Network access in code of documentationmcp-local-rag/references/html-ingestion.md:60Low confidence
- Network access in code of documentationmcp-local-rag/references/html-ingestion.md:61Low confidence
- Network access in code of documentationmcp-local-rag/references/html-ingestion.md:69Low confidence
- Network access in code of documentationmcp-local-rag/references/html-ingestion.md:70Low confidence
- Network access in code of documentationmcp-local-rag/references/html-ingestion.md:71Low confidence
Works with
| Agent | Status | Evidence | Install to |
|---|---|---|---|
| Claude Code | Compatible | Standard SKILL.md skills/mcp-local-rag/SKILL.md | .claude/skills/<skill-name>/ |
| Codex | Compatible | Standard SKILL.md skills/mcp-local-rag/SKILL.md | .agents/skills/<skill-name>/ |
| Cursor | Compatible | Standard SKILL.md skills/mcp-local-rag/SKILL.md | .cursor/skills/<skill-name>/ |
| Gemini CLI | Compatible | Standard SKILL.md skills/mcp-local-rag/SKILL.md | .gemini/skills/<skill-name>/ |
| GitHub Copilot | Compatible | Standard SKILL.md skills/mcp-local-rag/SKILL.md | .github/skills/<skill-name>/ |
| OpenCode | Compatible | Standard SKILL.md skills/mcp-local-rag/SKILL.md | .opencode/skills/<skill-name>/ |
- Native The repository ships a manifest, folder or frontmatter field for this agent.
- Compatible A standard SKILL.md that this agent can read.
- Unknown No evidence either way.
Derived automatically from paths, manifests and frontmatter. Not tested on each agent.
