Skip to main content
Glama
Pavloffm

universal-knowledge-base-mcp-server

by Pavloffm
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Universal knowledge base MCP server

The main idea of this project is to create universal MCP server core that can be reused with different knowledge bases. So there will be many different abstraction layers to control it.

Indexing

The Markdown knowledge base can be indexed recursively with a local sentence-transformers model:

uv run index-knowledge-base

Configure the knowledge base with environment variables or a .env file:

UKB_KNOWLEDGE_BASE_PATH=/path/to/knowledge-base
UKB_EMBEDDING_MODEL_NAME=sentence-transformers/all-MiniLM-L6-v2
UKB_EMBEDDING_DEVICE=cpu
UKB_NORMALIZE_EMBEDDINGS=true
UKB_VECTOR_DATABASE_FOLDER=.knowledge_base
UKB_CHUNK_SIZE=1000
UKB_CHUNK_OVERLAP=150
UKB_INDEX_BATCH_SIZE=100
UKB_RETRIEVAL_K=5
UKB_FORCE_UPDATE=false
UKB_INDEX_LOCK_TIMEOUT_SECONDS=60

UKB_KNOWLEDGE_BASE_PATH is required. Indexing and retrieval read all runtime configuration from these settings; the Python API accepts only the search query or no arguments. Chroma data and the SQLite record manager are stored in the configured vector database folder. Indexing is serialized with a lock, and the two stores are reconciled after interrupted runs.

How to run

Server

uv run universal-knowledge-base-mcp-server

Related MCP server: okf

Tests

uv run pytest

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • ragi

    SusuTawar
    A
    license
    A
    quality
    D
    maintenance
    Local-first RAG indexing and semantic search MCP server. Enables document retrieval and context-aware queries using local embedding models.
    3
    6
    MIT

  • okf

    aminHZDEV
    A
    license
    Not graded
    quality
    A
    maintenance
    Builds a keyword-searchable index from markdown documentation bundles and serves it to LLM agents via MCP, with retrieval logging and reporting for curation.
    MIT

  • mcp-rag

    shawndrake2
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables retrieval-augmented generation over a local markdown corpus, allowing grounded, cited answers via an MCP tool or CLI.
    9
    MIT

  • Vault RAG MCP

    rickquant
    A
    license
    Not graded
    quality
    C
    maintenance
    A read-only MCP server that enables semantic search and retrieval over a local Markdown knowledge base with heading-aware chunking and multilingual embeddings.
    MIT