[MLsys2026 Best Paper]: https://arxiv.org/abs/2506.08276. RAG on Everything with LEANN. Enjoy 97% storage savings while running a fast, accurate, and 100% private RAG application on your personal device.
Python aifaissgpt-osslangchainllama-indexllmlocalstorageoffline-firstollamaprivacypythonragretrieval-augmented-generationvector-databasevector-searchvectors
fix(mcp): resolve WinError 2 when leann CLI is not on PATH (#339)
Zhifei Li2159f1ff81c2
diff --git a/packages/leann-core/src/leann/__main__.py b/packages/leann-core/src/leann/__main__.pynew file mode 100644index 0000000..ec55b17--- /dev/null+++ b/packages/leann-core/src/leann/__main__.py@@ -0,0 +1,3 @@+from leann.cli import main++main()diff --git a/packages/leann-core/src/leann/cli.py b/packages/leann-core/src/leann/cli.pyindex 15a8a18..0d50cf3 100644--- a/packages/leann-core/src/leann/cli.py+++ b/packages/leann-core/src/leann/cli.py@@ -53,9 +53,15 @@ def suppress_cpp_output(suppress: bool = True):yieldreturn- # 1. Duplicate the original OS file descriptors- saved_stdout_fd = os.dup(1)- saved_stderr_fd = os.dup(2)+ # 1. Duplicate the original OS file descriptors.+ # May fail in no-console environments (e.g. pythonw, Windows GUI apps)+ # where fd 1/2 are not valid — in that case, skip suppression.+ try:+ saved_stdout_fd = os.dup(1)+ saved_stderr_fd = os.dup(2)+ except OSError:+ yield+ return# 2. Build Python file objects that write to the saved (real) fds.# closefd=False so closing these wrappers won't close the duped fds.@@ -2653,12 +2659,16 @@ Examples:print(f"Error: --metadata-filters is not valid JSON: {e}")return+ saved_fd = Noneif json_mode:sys.stdout.flush()- saved_fd = os.dup(1)- devnull = os.open(os.devnull, os.O_WRONLY)- os.dup2(devnull, 1)- os.close(devnull)+ try:+ saved_fd = os.dup(1)+ devnull = os.open(os.devnull, os.O_WRONLY)+ os.dup2(devnull, 1)+ os.close(devnull)+ except OSError:+ saved_fd = Nonetry:searcher = LeannSearcher(@@ -2679,7 +2689,7 @@ Examples:metadata_filters=metadata_filters,)finally:- if json_mode:+ if saved_fd is not None:sys.stdout.flush()os.dup2(saved_fd, 1)os.close(saved_fd)diff --git a/packages/leann-core/src/leann/mcp.py b/packages/leann-core/src/leann/mcp.pyindex cd3787e..c2f88be 100755--- a/packages/leann-core/src/leann/mcp.py+++ b/packages/leann-core/src/leann/mcp.py@@ -1,9 +1,22 @@#!/usr/bin/env python3+import argparseimport jsonimport subprocessimport sys+_base_dir: str | None = None+++def _leann_cmd() -> list[str]:+ """Build the base command for invoking ``leann`` CLI.++ Using ``sys.executable -m leann`` guarantees we find the CLI even when+ the ``leann`` console-script is not on PATH (common on Windows when+ launched by mcp-proxy or other service wrappers).+ """+ return [sys.executable, "-m", "leann"]+def handle_request(request):if request.get("method") == "initialize":@@ -100,7 +113,7 @@ def handle_request(request):}cmd = [- "leann",+ *_leann_cmd(),"search",args["index_name"],args["query"],@@ -111,10 +124,20 @@ def handle_request(request):]if args.get("show_metadata", False):cmd.append("--show-metadata")- result = subprocess.run(cmd, capture_output=True, text=True)+ result = subprocess.run(+ cmd,+ capture_output=True,+ text=True,+ cwd=_base_dir,+ )elif tool_name == "leann_list":- result = subprocess.run(["leann", "list"], capture_output=True, text=True)+ result = subprocess.run(+ [*_leann_cmd(), "list"],+ capture_output=True,+ text=True,+ cwd=_base_dir,+ )return {"jsonrpc": "2.0",@@ -140,6 +163,17 @@ def handle_request(request):def main():+ global _base_dir++ parser = argparse.ArgumentParser(description="LEANN MCP server (stdio)")+ parser.add_argument(+ "--base-dir",+ help="Base directory where LEANN indexes are located. "+ "The leann CLI will run with this as its working directory.",+ )+ cli_args = parser.parse_args()+ _base_dir = cli_args.base_dir+for line in sys.stdin:try:request = json.loads(line.strip())