Skip to main content
Glama
m2ux

concept-rag

by m2ux
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

🧠 Conceptual KB Search MCP Server

Node.js 18+ License: MIT MCP Compatible TypeScript

A RAG MCP server that enables LLMs to interact with a vector database chunked library of local PDF/EPUB documents through conceptual search. Combines corpus-driven concept extraction, WordNet semantic enrichment, and multi-signal hybrid ranking powered by LanceDB to augment retrieval accuracy.

Quick Start • Docs • Setup • Development • Contributing

🎯 Overview

Concept-RAG uses an Goal → Activity → Skill → Tool architecture to help AI agents to efficiently acquire knowledge.

After initial setup of an always-applied rule, agents are able to use an exposed guidance resource to:

  1. Match the user's goal to an activity (e.g., "understand a topic", "explore a concept")

  2. Follow the skill workflow which orchestrates the right tool sequence

  3. Synthesize the answer with citations

This reduces context overhead and provides deterministic tool selection.

Related MCP server: RAG Database MCP Server

🚀 Quick Start

Prerequisites

  • Node.js 18+

  • Python 3.9+ with NLTK

  • OpenRouter API key (sign up here)

  • MCP Client (Cursor or Claude Desktop)

Installation

# Clone and build
git clone https://github.com/m2ux/concept-rag.git
cd concept-rag
npm install
npm run build

# Install WordNet
pip3 install nltk
python3 -c "import nltk; nltk.download('wordnet'); nltk.download('omw-1.4')"

# Configure API key
cp .env.example .env
# Edit .env and add your OpenRouter API key

Seed Your Documents

source .env

# Initial seeding (create database)
npx tsx hybrid_fast_seed.ts \
  --dbpath ~/.concept_rag \
  --filesdir ~/Documents/my-pdfs \
  --overwrite

# Incremental seeding (add new documents only)
npx tsx hybrid_fast_seed.ts \
  --dbpath ~/.concept_rag \
  --filesdir ~/Documents/my-pdfs

Configure MCP Client

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "concept-rag": {
      "command": "node",
      "args": [
        "/path/to/concept-rag/dist/conceptual_index.js",
        "/home/username/.concept_rag"
      ]
    }
  }
}

Restart your MCP client and start searching. See SETUP.md for other IDEs.

🙏 Acknowledgments

Forked from lance-mcp by adiom-data.

📜 License

MIT License - see LICENSE for details.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers

  • Calibre RAG MCP Server

    ispyridis
    F
    license
    B
    quality
    D
    maintenance
    Enables semantic search and contextual conversations with your Calibre ebook library using vector-based RAG technology. Supports project-based organization, multi-format book processing, and OCR capabilities for enhanced content extraction and retrieval.
    7
    2
    -

  • RAG Database MCP Server

    Human-center
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to search and query PDF documents through a local RAG system with vector embeddings. Provides semantic document search capabilities while keeping all data stored locally without external dependencies.
    -

  • PDF RAG MCP Server

    wesleygriffin
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables intelligent search and question-answering over PDF documents using semantic similarity and keyword search. Supports OCR for scanned PDFs, persistent vector storage with ChromaDB, and maintains source tracking with page numbers.
    6
    MIT

  • RooCode-RAG-Lookup

    Mazchoo
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables semantic search across documents and code repositories using RAG (Retrieval-Augmented Generation) with vector embeddings. Automatically indexes PDF documents and performs relevance-scored lookups through ChromaDB and sentence transformers.
    -