AgentSidekick

mcp-local-rag

MCP serverby shinprSRC

Easy-to-setup local RAG server with minimal configuration

SRC Publisher-stated: these are the publisher's own words, not an assessment.

RepositorySource listing

Key facts

Type
MCP server · mcp-localSRC
Publisher
shinpr · individualSRC
Licence
MITSRC
Open source
YesDER
Hosting
Local (runs on your machine)SRC
Latest version
0.23.3SRC
Languages
typescriptSRC
First published
SRC
In this catalogue since
DER
Last verified
Not verified by a researcher. Last seen in a source on 2026-11-21.

Capabilities and categories

Assigned by keyword rules from the description unless marked otherwise. The matched word is shown so you can judge the match.

CapabilityEvidenceKind
Retrieval-Augmented Generationmatched ragDER
Vector Databasesmatched vector searchDER
Semantic Searchmatched semantic searchDER
Similarity Searchmatched hybrid searchDER

Filed underData & KnowledgeRetrieval & RAG

Integrations DER

No third-party service is named in the description or package metadata.

Platform compatibility

No pairing has been tested by AgentSidekick. Each status says what kind of evidence exists, not whether it works for you.

Protocol-level29

Each platform listed officially documents support for MCP. This specific pairing has not been tested.

Platform discontinued1
PlatformBasis
Roo CodeDiscontinuedRoo Code documented support for MCP but is discontinued. Project shut down and repository archived.
Unknown17
PlatformBasis
OpenClawCould not confirm whether OpenClaw supports MCP.
OpenHandsOpenHands documents MCP support, but it runs only on web, api, slack surfaces and this server runs locally as a process on your machine. Whether OpenHands can reach a local server is not established.
AiderCould not confirm whether Aider supports MCP.
Bolt (bolt.new)Bolt (bolt.new) documents MCP support, but it runs only on web surfaces and this server runs locally as a process on your machine. Whether Bolt (bolt.new) can reach a local server is not established.
Amazon Q DeveloperWinding downCould not confirm whether Amazon Q Developer supports MCP.
Amazon Bedrock Agents (Agents Classic)Maintenance onlyCould not confirm whether Amazon Bedrock Agents (Agents Classic) supports MCP.
GPTs (custom GPTs)Winding downCould not confirm whether GPTs (custom GPTs) supports MCP.
Gemini (app)Gemini (app) documents MCP support, but it runs only on web, mobile surfaces and this server runs locally as a process on your machine. Whether Gemini (app) can reach a local server is not established.
Gemini Enterprise Agent Platform (formerly Vertex AI / Vertex AI Agent Builder)Gemini Enterprise Agent Platform (formerly Vertex AI / Vertex AI Agent Builder) documents MCP support, but it runs only on web, api surfaces and this server runs locally as a process on your machine. Whether Gemini Enterprise Agent Platform (formerly Vertex AI / Vertex AI Agent Builder) can reach a local server is not established.
GitHub Copilot ExtensionsDiscontinuedCould not confirm whether GitHub Copilot Extensions supports MCP.
Google AI StudioCould not confirm whether Google AI Studio supports MCP.
JulesWinding downCould not confirm whether Jules supports MCP.
Microsoft CopilotCould not confirm whether Microsoft Copilot supports MCP.
Microsoft Copilot StudioMicrosoft Copilot Studio documents MCP support, but it runs only on web surfaces and this server runs locally as a process on your machine. Whether Microsoft Copilot Studio can reach a local server is not established.
Replit AgentReplit Agent documents MCP support, but it runs only on web surfaces and this server runs locally as a process on your machine. Whether Replit Agent can reach a local server is not established.
Sourcegraph CodyCould not confirm whether Sourcegraph Cody supports MCP.
v0v0 documents MCP support, but it runs only on web, api surfaces and this server runs locally as a process on your machine. Whether v0 can reach a local server is not established.

Install

Read from registry metadata. Follow the publisher's instructions; we have not run this.

Packages
RegistryPackageTransportRuntime
npmmcp-local-ragstdionot stated

Environment variables SRC

NameRequiredSecretPublisher's description
BASE_DIRNoNoBase directory for document storage (defaults to current working directory). Ignored when BASE_DIRS is set.
BASE_DIRSNoNoJSON array of base directories (e.g. '["/a","/b"]'). Takes precedence over BASE_DIR.
IGNORE_PATHSNoNoJSON array of glob patterns for files to keep out of the index, each matched against the file's path relative to its root (e.g. '["plugs/**","**/*.draft.md"]').
DB_PATHNoNoPath to LanceDB database directory (defaults to ./lancedb/)
CACHE_DIRNoNoDirectory where Transformers.js models are cached (defaults to ./models/)
HF_ENDPOINTNoNoHugging Face model download endpoint. Set this to a mirror URL when direct downloads are blocked (defaults to https://huggingface.co).
MODEL_NAMENoNoEmbedding model name (defaults to Xenova/all-MiniLM-L6-v2)
MAX_FILE_SIZENoNoMaximum file size in bytes (defaults to 104857600 / 100MB)
RAG_MAX_DISTANCENoNoMaximum distance threshold for filtering search results. Results with distance greater than this value will be excluded. Lower values mean stricter filtering (e.g., 0.5 for high relevance only)
RAG_GROUPINGNoNoGrouping mode for quality filtering. 'similar' returns only the most similar group (stops at first distance jump). 'related' includes related groups (stops at second distance jump). Unset means no grouping filter
RAG_MAX_FILESNoNoMaximum number of files to keep in search results. Results are filtered to include only chunks from the top N best-scoring files. For example, 1 returns only the single best-matching file's chunks. Unset means no file filtering.
CHUNK_MIN_LENGTHNoNoMinimum chunk length in characters (1-10000, defaults to 50). Chunks shorter than this threshold are filtered out during ingestion.
STORE_IMAGESNoNoStore supported PDF and DOCX images during ingestion and return them with matched chunks (defaults to false).
EMBED_TITLE_PREFIXNoNoEmbed each chunk together with its document title, which can help when passages don't restate the topic the title names (defaults to false). After changing it, use a new DB_PATH or delete the index and re-ingest.
EMBED_HEADING_PREFIXNoNoAdd section headings to chunk embeddings when they fit (defaults to false). Independent of EMBED_TITLE_PREFIX. Re-ingest documents after changing it.
RAG_DEVICENoNoExecution device for the embedder (defaults to cpu). Passed straight to ONNX Runtime; see the Transformers.js device source for the supported backend names. If the requested device fails to initialize, the server throws an error.
RAG_DTYPENoNoEmbedding quantization dtype for the embedder (defaults to fp32). Opt-in and pass-through; accepts any dtype the chosen model provides (fp32, fp16, q8, int8, ...). If the model has no variant for the requested dtype, the server throws an error. Changing this changes the embedding space — re-ingest existing data.
RAG_HYBRID_WEIGHTNoNoKeyword boost factor for hybrid search (0.0-1.0, defaults to 0.6). 0 means semantic similarity only; higher values increase the keyword-match contribution to the final score.
RAG_RERANK_CMDNoNoExternal reranker command template. Use {query} and {top} for query text and result count; unset disables reranking.
RAG_RERANK_TIMEOUT_MSNoNoTime budget per rerank call in milliseconds (100-600000, defaults to 10000). On timeout the spawned command is killed and the pre-rerank ordering is returned.

Permissions and signals

Signals, not a safety verdict. They describe what the product's metadata references. Security review: not reviewed.

SignalEvidenceHow observedObserved
Runs a local processruns locally via npmregistry metadata 2026-11-21

Known advisories for the published package SRC

An advisory existing does not mean the listed version is affected: compare the vulnerable range with the version you install. None found is not evidence of safety.

No advisories found

No published advisory matches a package this product declares. Products without a declared package cannot be matched at all. This is not evidence of safety.

Evaluation

Separate dimensions, each with its evidence. There is no overall score: the dimensions do not add up to one number honestly.

Source authority

Publisher-submitted

Published to the official MCP Registry by the namespace owner. Field values are the publisher's own claims.

Publisher verification

Namespace verified by registry

The MCP Registry verifies namespace ownership (GitHub login or DNS) before publishing. This confirms who published it, not what it does.

Maintenance activity

Active

Last push 2026-11-13 (8 days before this page was built).

Licence clarity

MIT

Licence identifier as reported by GitHub repository metadata.

Installation clarity

Machine-readable

1 package(s) and 0 remote endpoint(s) declared in registry metadata.

Documentation

Repository / website only

No dedicated documentation URL on record. AgentSidekick has not assessed documentation quality.

Compatibility evidence

Protocol-level only

Compatibility is inferred from the standard it implements. No pairing has been tested.

Security review

Not reviewed

AgentSidekick has not audited this product. 1 automated signal(s) are listed under Permissions & signals — they describe what it references, not whether it is safe.

Pricing

Not published in any source we track. The code is open source, which says nothing about the cost of any hosted service.

Repository activity

shinpr/mcp-local-rag. Read from the GitHub API on 2026-11-21.

436SRCGitHub stars
83SRCForks
1SRCOpen issues
8d agoSRCLast push2026-11-13
v0.23.3SRCLatest release2026-11-11

Version history SRC

  1. 0.23.3
  2. 0.23.2
  3. 0.23.1
  4. 0.23.0
  5. 0.22.1
  6. 0.22.0
  7. 0.21.3
  8. 0.21.2
32 earlier versions (the 40 most recent of 66 are listed)
  1. 0.21.1
  2. 0.21.0
  3. 0.20.1
  4. 0.20.0
  5. 0.19.1
  6. 0.19.0
  7. 0.18.6
  8. 0.18.5
  9. 0.18.4
  10. 0.18.2
  11. 0.18.1
  12. 0.18.0
  13. 0.17.4
  14. 0.17.3
  15. 0.17.2
  16. 0.17.1
  17. 0.17.0
  18. 0.16.1
  19. 0.16.0
  20. 0.15.4
  21. 0.15.3
  22. 0.15.2
  23. 0.15.1
  24. 0.15.0
  25. 0.14.2
  26. 0.14.1
  27. 0.14.0
  28. 0.13.2
  29. 0.13.1
  30. 0.13.0
  31. 0.12.0
  32. 0.11.1

Change history

What changed between two ingests of the same source, and when the product was first seen. Registry releases are under Version history.

  1. First seen

Competitors and alternativesDER

Paired by shared capabilities and integrations. Similar on paper; not tested side by side.

Direct

Same type, overlapping capabilities.

calibre-mcp

MCP serverby caelum29SRC

33 GitHub starspushed 1d agoMIT

SharesVector DatabasesSimilarity SearchRetrieval-Augmented GenerationSemantic Search

magpie-search

MCP serverby xfloukiex-labSRC

29 GitHub starspushed 2mo agoApache-2.0

SharesSimilarity SearchRetrieval-Augmented GenerationSemantic Search

Qdrant MCP

MCP serverby avaazquezzSRC

2 GitHub starspushed 6d agoMIT

SharesVector DatabasesSimilarity SearchRetrieval-Augmented GenerationSemantic Search

XERJ

MCP serverby xerj-orgSRC

19k GitHub starspushed todayApache-2.0

SharesVector DatabasesSimilarity SearchRetrieval-Augmented Generation

Adjacent

A different form or a partial overlap.

zvec

Agent skillby alibabaHEU

16k GitHub starspushed 1d agoApache-2.0

SharesVector DatabasesSimilarity SearchRetrieval-Augmented GenerationSemantic Search

FlashRank

Infrastructureby PrithivirajDamodaranHEU

1.0k GitHub starspushed 4mo agoApache-2.0

SharesVector DatabasesSimilarity SearchRetrieval-Augmented GenerationSemantic Search

meilisearch

Infrastructureby meilisearchHEU

60k GitHub starspushed 1d agolicence unknown

SharesVector DatabasesSimilarity SearchSemantic Search

Milvus

Infrastructureby Zilliz (LF AI & Data)CUR

47k GitHub starspushed todayApache-2.0

SharesVector DatabasesSimilarity SearchRetrieval-Augmented Generation

Weaviate

Infrastructureby weaviateCUR

17k GitHub starspushed todayBSD-3-Clause

SharesVector DatabasesSimilarity SearchSemantic Search

orama

Infrastructureby oramasearchHEU

11k GitHub starspushed 1mo agolicence unknown

SharesVector DatabasesSimilarity SearchRetrieval-Augmented Generation

Provenance

Which source set each field, what kind of claim it is, and when.

FieldSourceKindSet on
Canonical URLOfficial MCP RegistrySRC2026-11-21
PublisherOfficial MCP RegistrySRC2026-11-21
DescriptionOfficial MCP RegistrySRC2026-11-21
HostingOfficial MCP RegistrySRC2026-11-21
Integration typeOfficial MCP RegistrySRC2026-11-21
LanguagesGitHub repository metadataSRC2026-11-21
Latest versionOfficial MCP RegistrySRC2026-11-21
LicenceGitHub repository metadataSRC2026-11-21
NameOfficial MCP RegistrySRC2026-11-21
Open sourceGitHub repository metadataDER2026-11-21
TypeOfficial MCP RegistrySRC2026-11-21
PublishedOfficial MCP RegistrySRC2026-11-21
RepositoryOfficial MCP RegistrySRC2026-11-21
source_updated_atOfficial MCP RegistrySRC2026-11-21
Source URLOfficial MCP RegistrySRC2026-11-21

Sources

Not verified by a researcher. Last seen in a source on . Report incorrect information

Page data last updated .