From 0f790fbbd963be1496fecedb5f31e91c38550d2a Mon Sep 17 00:00:00 2001
From: yichuan520030910320
Date: Fri, 8 Aug 2025 00:56:05 -0700
Subject: [PATCH] docs: polish README and add optimized MCP integration image
- Improve grammar and sentence structure in MCP section
- Add proper markdown image formatting with relative paths
- Optimize mcp_leann.png size (1.3MB -> 224KB)
- Update data description to be more specific about Chinese content
---
README.md | 54 +++++++++++++++++------------------
assets/mcp_leann.png | Bin 0 -> 229850 bytes
packages/leann-mcp/README.md | 2 +-
3 files changed, 28 insertions(+), 28 deletions(-)
create mode 100644 assets/mcp_leann.png
diff --git a/README.md b/README.md
index a1f9da9..24ff0f0 100755
--- a/README.md
+++ b/README.md
@@ -6,6 +6,7 @@
+
@@ -16,7 +17,10 @@ LEANN is an innovative vector database that democratizes personal AI. Transform
LEANN achieves this through *graph-based selective recomputation* with *high-degree preserving pruning*, computing embeddings on-demand instead of storing them all. [Illustration Fig →](#️-architecture--how-it-works) | [Paper →](https://arxiv.org/abs/2506.08276)
-**Ready to RAG Everything?** Transform your laptop into a personal AI assistant that can search your **[codebase](#-claude-code-integration-transform-your-development-workflow)**, **[file system](#-personal-data-manager-process-any-documents-pdf-txt-md)**, **[emails](#-your-personal-email-secretary-rag-on-apple-mail)**, **[browser history](#-time-machine-for-the-web-rag-your-entire-browser-history)**, **[chat history](#-wechat-detective-unlock-your-golden-memories)**, or external knowledge bases (i.e., 60M documents) - all on your laptop, with zero cloud costs and complete privacy.
+**Ready to RAG Everything?** Transform your laptop into a personal AI assistant that can semantic search your **[file system](#-personal-data-manager-process-any-documents-pdf-txt-md)**, **[emails](#-your-personal-email-secretary-rag-on-apple-mail)**, **[browser history](#-time-machine-for-the-web-rag-your-entire-browser-history)**, **[chat history](#-wechat-detective-unlock-your-golden-memories)**, **[codebase](#-claude-code-integration-transform-your-development-workflow)**\* , or external knowledge bases (i.e., 60M documents) - all on your laptop, with zero cloud costs and complete privacy.
+
+
+\* Claude Code only supports basic `grep`-style keyword search. **LEANN** is a drop-in **semantic search MCP service fully compatible with Claude Code**, unlocking intelligent retrieval without changing your workflow.
@@ -26,7 +30,7 @@ LEANN achieves this through *graph-based selective recomputation* with *high-deg
-> **The numbers speak for themselves:** Index 60 million Wikipedia chunks in just 6GB instead of 201GB. From emails to browser history, everything fits on your laptop. [See detailed benchmarks for different applications below ↓](#storage-comparison)
+> **The numbers speak for themselves:** Index 60 million text chunks in just 6GB instead of 201GB. From emails to browser history, everything fits on your laptop. [See detailed benchmarks for different applications below ↓](#storage-comparison)
🔒 **Privacy:** Your data never leaves your laptop. No OpenAI, no cloud, no "terms of service".
@@ -211,30 +215,6 @@ All RAG examples share these common parameters. **Interactive mode** is availabl
-### 🚀 Claude Code Integration: Transform Your Development Workflow!
-
-**The future of code assistance is here.** Transform your development workflow with LEANN's native MCP integration for Claude Code. Index your entire codebase and get intelligent code assistance directly in your IDE.
-
-
-
-
-
-
-**Key features:**
-- 🔍 **Semantic code search** across your entire project
-- 📚 **Context-aware assistance** for debugging and development
-- 🚀 **Zero-config setup** with automatic language detection
-- 🔒 **Complete privacy** - your code never leaves your machine
-
-```bash
-# Install LEANN globally for MCP integration
-uv tool install leann-core
-
-# Setup is automatic - just start using Claude Code!
-```
-
-**Ready to supercharge your coding?** [Complete Setup Guide →](packages/leann-mcp/README.md)
-
### 📄 Personal Data Manager: Process Any Documents (`.pdf`, `.txt`, `.md`)!
Ask questions directly about your personal PDFs, documents, and any directory containing your files!
@@ -243,7 +223,7 @@ Ask questions directly about your personal PDFs, documents, and any directory co
-The example below asks a question about summarizing our paper (uses default data in `data/`, which is a directory with diverse data sources: two papers, Pride and Prejudice, and a README in Chinese) and this is the **easiest example** to run here:
+The example below asks a question about summarizing our paper (uses default data in `data/`, which is a directory with diverse data sources: two papers, Pride and Prejudice, and a Technical report about LLM in Huawei in Chinese), and this is the **easiest example** to run here:
```bash
source .venv/bin/activate # Don't forget to activate the virtual environment
@@ -438,6 +418,26 @@ Once the index is built, you can ask questions like:
+### 🚀 Claude Code Integration: Transform Your Development Workflow!
+
+**The future of code assistance is here.** Transform your development workflow with LEANN's native MCP integration for Claude Code. Index your entire codebase and get intelligent code assistance directly in your IDE.
+
+**Key features:**
+- 🔍 **Semantic code search** across your entire project
+- 📚 **Context-aware assistance** for debugging and development
+- 🚀 **Zero-config setup** with automatic language detection
+
+```bash
+# Install LEANN globally for MCP integration
+uv tool install leann-core
+
+# Setup is automatic - just start using Claude Code!
+```
+Try our fully agentic pipeline with auto query rewriting, semantic search planning, and more:
+
+
+
+**Ready to supercharge your coding?** [Complete Setup Guide →](packages/leann-mcp/README.md)
## 🖥️ Command Line Interface
diff --git a/assets/mcp_leann.png b/assets/mcp_leann.png
new file mode 100644
index 0000000000000000000000000000000000000000..de5ed0491cc15a59354a590718c7b0ca29f89f0b
GIT binary patch
literal 229850
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