MCP Server for LightRAG with smart document upsert capabilities
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"mcp-lightrag","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# LightRAG MCP Server A Model Context Protocol (MCP) server that enables AI assistants to interact with [LightRAG](https://github.com/HKUDS/LightRAG) knowledge graphs. Query documents, manage entities, and build semantic relationships through a standardized tool interface. **Optimized for Obsidian Vaults**: The built-in smart upsert and document tracking capabilities make it perfect for agents that need to sync and reason over evolving Obsidian knowledge bases. ## Features - **Smart Updates**: Intelligent `upsert` logic that detects changes in documents, skipping redundant uploads and re-indexing only when necessary - **Knowledge Graph Queries**: Perform semantic, keyword, or hybrid searches across your indexed documents - **Document Ingestion**: Add text, files, or entire directories to your knowledge base - **Entity Management**: Create, update, merge, and delete entities in the graph - **Relationship Handling**: Define and modify connections between entities - **Robust Connectivity**: Automatic retry with exponential backoff for reliable API communication - **Flexible Configuration**: Set options via environment variables or command-line arguments ## Installation ```bash # Clone the repository git clone https://github.com/enriquecatala/mcp-lightrag.git cd mcp-lightrag # Install dependencies uv sync ``` ## Quick Start 1. **Start your LightRAG server** (must be running before the MCP server) 2. **Launch the MCP server**: ```bash uv run mcp-lightrag --host localhost --port 9621 ``` 3. **Connect your AI assistant** via the MCP protocol (stdio transport) ## Configuration | Option | Environment Variable | Default | Description | | ------------- | -------------------- | ----------- | ----------------- | | `--host` | `LIGHTRAG_HOST` | `localhost` | LightRAG API host | | `--port` | `LIGHTRAG_PORT` | `9621` | LightRAG API port | | `--api-key` | `LIGHTRAG_API_KEY` | *(none)* | Optional API key | | `--lo…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.