io.github.ndjordjevic/pinrag

MCP RAG: index PDFs, repos, YouTube, Discord, text; optional YouTube vision; query with citations.

1 6 tools GitHub

No known CVEs

No license

Maintained

Last commit 49d ago

Works with most clients

Transport: stdio

6 tools · ~867 tok

Grade B · 0.4% of 200K ctx

Edit this pageView history

AI / ML Search

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "io-github-ndjordjevic-pinrag": {
      "command": "<see-readme>",
      "args": []
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-ndjordjevic-pinrag)](https://mcppedia.org/s/io-github-ndjordjevic-pinrag)

Read me

What io.github.ndjordjevic/pinrag does

PinRAG is for when you want to learn about something and your materials are scattered—PDFs and ebooks, GitHub repos, YouTube videos, Discord discussions, and plain notes. You index those materials into one shared RAG index, then ask questions from Cursor, VS Code (GitHub Copilot), or any MCP-capable assistant and get answers with citations pointing back to pages, timestamps, files, or threads.

Test This Server

No automated test available for this server. Check the GitHub README for setup instructions.

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

62/100across 5 weighted dimensions

How we score →

0255075100

−38

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

No package registry to scan.

Inventory

Tools (6)

Click any tool to inspect its schema.

~867 tokens total

Inventory

Resources (2)

documents

Indexed documents with metadata including document type, tags, page/message/segment counts, titles, bytes, and upload timestamp

pinrag://documents

server-config

Server configuration including environment variables and effective settings such as PINRAG_VERSION

pinrag://server-config

Inventory

Prompts (1)

use_pinrag

MCP prompt for querying, indexing, listing, or removing documents from PinRAG

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.ndjordjevic/pinrag safe to use?: io.github.ndjordjevic/pinrag has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.ndjordjevic/pinrag?: io.github.ndjordjevic/pinrag can be installed by cloning its GitHub repository and following the setup instructions in the README.
What can io.github.ndjordjevic/pinrag do?: io.github.ndjordjevic/pinrag provides 6 tools: add_document_tool, query_tool, list_documents_tool, remove_document_tool, set_document_tag_tool and 1 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.ndjordjevic/pinrag?: io.github.ndjordjevic/pinrag is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.
Is io.github.ndjordjevic/pinrag actively maintained?: io.github.ndjordjevic/pinrag is recently maintained — last commit was 49 days ago. It has 1 GitHub stars.

Similar servers

Others in ai-ml / search

View all →

Memory MCP Server98

Persistent memory using a knowledge graph

86.5k 5

Sequential Thinking MCP Server98

Dynamic problem-solving through sequential thought chains

86.5k 1

Brave Search MCP Server98

Web and local search using Brave Search API

86.4k 2

Tavily Mcp96

Production ready MCP server with real-time search, extract, map & crawl.

2.0k 4

MCP Security Weekly

Get CVE alerts and security updates for io.github.ndjordjevic/pinrag and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Overview

PinRAG is for when you want to learn about something and your materials are scattered—PDFs and ebooks, GitHub repos, YouTube videos, Discord discussions, and plain notes. You index those materials into one shared RAG index, then ask questions from Cursor, VS Code (GitHub Copilot), or any MCP-capable assistant and get answers with citations pointing back to pages, timestamps, files, or threads.

Under the hood it is Retrieval-Augmented Generation built with LangChain and exposed as an MCP (Model Context Protocol) server: add documents from the editor, query with natural language, list or remove what you indexed. Supported inputs include PDFs, local text files and directories, Discord exports, YouTube (transcript from URL, playlist, or ID), and GitHub repo URLs. For YouTube you can optionally add vision so on-screen code, diagrams, and UI text are merged with the transcript in the same chunks—see YouTube vision enrichment.

Features

Multi-format indexing — PDF (.pdf), local files or directories, plain text (.txt), Discord export (.txt), YouTube (video or playlist URL, or video ID), GitHub repo (URL), web documentation sites (URL)

Optional YouTube vision — Off by default. When enabled, runs a vision model (OpenAI, Anthropic, or OpenRouter native video) and merges structured on-screen context with the transcript so RAG chunks carry searchable code names, labels, and diagrams—not speech alone. OpenRouter mode avoids local ffmpeg/video download; openai/anthropic use scene keyframes and require pinrag[vision] + ffmpeg (see YouTube vision enrichment)

RAG with citations — Answers cite source context: PDF page, YouTube timestamp, document name for plain text and Discord, chunk index for GitHub repos, source URL for web documentation

Document tags — Tag documents at index time (e.g. AMIGA, PI_PICO) for filtered search

Metadata filtering — query_tool supports document_id, tag, document_type, PDF page_min/page_max, and response_style (thorough or concise)

MCP tools — add_document_tool, query_tool, list_documents_tool, remove_document_tool, set_document_tag_tool, list_collections_tool; optional collection on tools overrides PINRAG_COLLECTION_NAME for that call

MCP resources — pinrag://documents (indexed documents) and pinrag://server-config (env vars and config); click in Cursor’s MCP panel to view

MCP prompt — use_pinrag (parameter: request) for querying, indexing, listing, or removing documents

Configurable LLM — OpenRouter (default, free openrouter/free router), OpenAI, Anthropic, or Cerebras Inference (OpenAI-compatible API); set via PINRAG_LLM_PROVIDER and PINRAG_LLM_MODEL in MCP env or your shell

Local embeddings — Nomic (PINRAG_EMBEDDING_MODEL, default nomic-embed-text-v1.5); no API key; first run downloads model weights (~270 MB, cached)

Retrieval & chunking options — Structu

Frequently Asked Questions

Is io.github.ndjordjevic/pinrag safe to use?

io.github.ndjordjevic/pinrag has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install io.github.ndjordjevic/pinrag?

io.github.ndjordjevic/pinrag can be installed by cloning its GitHub repository and following the setup instructions in the README.

What can io.github.ndjordjevic/pinrag do?

io.github.ndjordjevic/pinrag provides 6 tools: add_document_tool, query_tool, list_documents_tool, remove_document_tool, set_document_tag_tool and 1 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with io.github.ndjordjevic/pinrag?

io.github.ndjordjevic/pinrag is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.

Is io.github.ndjordjevic/pinrag actively maintained?

io.github.ndjordjevic/pinrag is recently maintained — last commit was 49 days ago. It has 1 GitHub stars.

Overview

Features

RAG with citations — Answers cite source context: PDF page, YouTube timestamp, document name for plain text and Discord, chunk index for GitHub repos, source URL for web documentation

Document tags — Tag documents at index time (e.g. AMIGA, PI_PICO) for filtered search

Metadata filtering — query_tool supports document_id, tag, document_type, PDF page_min/page_max, and response_style (thorough or concise)

MCP resources — pinrag://documents (indexed documents) and pinrag://server-config (env vars and config); click in Cursor’s MCP panel to view

MCP prompt — use_pinrag (parameter: request) for querying, indexing, listing, or removing documents

Local embeddings — Nomic (PINRAG_EMBEDDING_MODEL, default nomic-embed-text-v1.5); no API key; first run downloads model weights (~270 MB, cached)

Retrieval & chunking options — Structu