Skip to content

armgit / LEANN

Public Imported from GitHub
0

[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.

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__.py
new file mode 100644
index 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.py
index 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):
yield
return
- # 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 = None
if 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 = None
try:
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.py
index 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 argparse
import json
import subprocess
import 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())