lean-lsp-mcp 0.9.1__py3-none-any.whl → 0.10.1__py3-none-any.whl

lean_lsp_mcp/client_utils.py

@@ -1,4 +1,4 @@
-import os
+from pathlib import Path
 
 from mcp.server.fastmcp import Context
 from mcp.server.fastmcp.utilities.logging import get_logger
@@ -25,38 +25,39 @@ def startup_client(ctx: Context):
     client: LeanLSPClient | None = ctx.request_context.lifespan_context.client
 
     if client is not None:
+        # Both are Path objects now, direct comparison works
         if client.project_path == lean_project_path:
-            return
+            return  # Client already set up correctly - reuse it!
+        # Different project path - close old client
         client.close()
         ctx.request_context.lifespan_context.file_content_hashes.clear()
 
+    # Need to create a new client
     with OutputCapture() as output:
         try:
-            client = LeanLSPClient(
-                lean_project_path, initial_build=True, print_warnings=False
-            )
+            client = LeanLSPClient(lean_project_path)
             logger.info(f"Connected to Lean language server at {lean_project_path}")
         except Exception as e:
-            client = LeanLSPClient(
-                lean_project_path, initial_build=False, print_warnings=False
-            )
-            logger.error(f"Could not do initial build, error: {e}")
-    logger.info("Build output: " + output.get_output())
+            logger.warning(f"Initial connection failed, trying with build: {e}")
+            client = LeanLSPClient(lean_project_path, initial_build=True)
+            logger.info(f"Connected with initial build to {lean_project_path}")
+    build_output = output.get_output()
+    if build_output:
+        logger.debug(f"Build output: {build_output}")
     ctx.request_context.lifespan_context.client = client
 
 
-def valid_lean_project_path(path: str) -> bool:
+def valid_lean_project_path(path: Path | str) -> bool:
     """Check if the given path is a valid Lean project path (contains a lean-toolchain file).
 
     Args:
-        path (str): Absolute path to check.
+        path (Path | str): Absolute path to check.
 
     Returns:
         bool: True if valid Lean project path, False otherwise.
     """
-    if not os.path.exists(path):
-        return False
-    return os.path.isfile(os.path.join(path, "lean-toolchain"))
+    path_obj = Path(path) if isinstance(path, str) else path
+    return (path_obj / "lean-toolchain").is_file()
 
 
 def setup_client_for_file(ctx: Context, file_path: str) -> str | None:
@@ -77,12 +78,12 @@ def setup_client_for_file(ctx: Context, file_path: str) -> str | None:
             startup_client(ctx)
             return rel_path
 
-    # Try to find the new correct project path by checking all directories in file_path.
-    file_dir = os.path.dirname(file_path)
+    # Try to find the correct project path by checking all directories in file_path.
+    file_path_obj = Path(file_path)
     rel_path = None
-    while file_dir:
-        if valid_lean_project_path(file_dir):
-            lean_project_path = file_dir
+    for parent in file_path_obj.parents:
+        if valid_lean_project_path(parent):
+            lean_project_path = parent
             rel_path = get_relative_file_path(lean_project_path, file_path)
             if rel_path is not None:
                 ctx.request_context.lifespan_context.lean_project_path = (
@@ -90,7 +91,5 @@ def setup_client_for_file(ctx: Context, file_path: str) -> str | None:
                 )
                 startup_client(ctx)
                 break
-        # Move up one directory
-        file_dir = os.path.dirname(file_dir)
 
     return rel_path

lean_lsp_mcp/file_utils.py

@@ -1,5 +1,6 @@
 import os
 from typing import Optional, Dict
+from pathlib import Path
 
 from mcp.server.fastmcp import Context
 from mcp.server.fastmcp.utilities.logging import get_logger
@@ -9,30 +10,39 @@ from leanclient import LeanLSPClient
 logger = get_logger(__name__)
 
 
-def get_relative_file_path(lean_project_path: str, file_path: str) -> Optional[str]:
+def get_relative_file_path(lean_project_path: Path, file_path: str) -> Optional[str]:
     """Convert path relative to project path.
 
     Args:
-        lean_project_path (str): Path to the Lean project root.
+        lean_project_path (Path): Path to the Lean project root.
         file_path (str): File path.
 
     Returns:
         str: Relative file path.
     """
+    file_path_obj = Path(file_path)
+
     # Check if absolute path
-    if os.path.exists(file_path):
-        return os.path.relpath(file_path, lean_project_path)
+    if file_path_obj.is_absolute() and file_path_obj.exists():
+        try:
+            return str(file_path_obj.relative_to(lean_project_path))
+        except ValueError:
+            # File is not in this project
+            return None
 
     # Check if relative to project path
-    path = os.path.join(lean_project_path, file_path)
-    if os.path.exists(path):
-        return os.path.relpath(path, lean_project_path)
+    path = lean_project_path / file_path
+    if path.exists():
+        return str(path.relative_to(lean_project_path))
 
     # Check if relative to CWD
-    cwd = os.getcwd().strip()  # Strip necessary?
-    path = os.path.join(cwd, file_path)
-    if os.path.exists(path):
-        return os.path.relpath(path, lean_project_path)
+    cwd = Path.cwd()
+    path = cwd / file_path
+    if path.exists():
+        try:
+            return str(path.relative_to(lean_project_path))
+        except ValueError:
+            return None
 
     return None
 
@@ -58,10 +68,8 @@ def update_file(ctx: Context, rel_path: str) -> str:
         str: Updated file contents.
     """
     # Get file contents and hash
-    abs_path = os.path.join(
-        ctx.request_context.lifespan_context.lean_project_path, rel_path
-    )
-    file_content = get_file_contents(abs_path)
+    abs_path = ctx.request_context.lifespan_context.lean_project_path / rel_path
+    file_content = get_file_contents(str(abs_path))
     hashed_file = hash(file_content)
 
     # Check if file_contents have changed

lean_lsp_mcp/server.py

@@ -43,7 +43,7 @@ _RG_AVAILABLE, _RG_MESSAGE = check_ripgrep_status()
 # Server and context
 @dataclass
 class AppContext:
-    lean_project_path: str | None
+    lean_project_path: Path | None
     client: LeanLSPClient | None
     file_content_hashes: Dict[str, str]
     rate_limit: Dict[str, List[int]]
@@ -53,11 +53,11 @@ class AppContext:
 @asynccontextmanager
 async def app_lifespan(server: FastMCP) -> AsyncIterator[AppContext]:
     try:
-        lean_project_path = os.environ.get("LEAN_PROJECT_PATH", "").strip()
-        if not lean_project_path:
+        lean_project_path_str = os.environ.get("LEAN_PROJECT_PATH", "").strip()
+        if not lean_project_path_str:
             lean_project_path = None
         else:
-            lean_project_path = os.path.abspath(lean_project_path)
+            lean_project_path = Path(lean_project_path_str).resolve()
 
         context = AppContext(
             lean_project_path=lean_project_path,
@@ -136,10 +136,10 @@ def lsp_build(ctx: Context, lean_project_path: str = None, clean: bool = False)
         str: Build output or error msg
     """
     if not lean_project_path:
-        lean_project_path = ctx.request_context.lifespan_context.lean_project_path
+        lean_project_path_obj = ctx.request_context.lifespan_context.lean_project_path
     else:
-        lean_project_path = os.path.abspath(lean_project_path)
-        ctx.request_context.lifespan_context.lean_project_path = lean_project_path
+        lean_project_path_obj = Path(lean_project_path).resolve()
+        ctx.request_context.lifespan_context.lean_project_path = lean_project_path_obj
 
     build_output = ""
     try:
@@ -149,15 +149,11 @@ def lsp_build(ctx: Context, lean_project_path: str = None, clean: bool = False)
             ctx.request_context.lifespan_context.file_content_hashes.clear()
 
         if clean:
-            subprocess.run(["lake", "clean"], cwd=lean_project_path, check=False)
+            subprocess.run(["lake", "clean"], cwd=lean_project_path_obj, check=False)
             logger.info("Ran `lake clean`")
 
         with OutputCapture() as output:
-            client = LeanLSPClient(
-                lean_project_path,
-                initial_build=True,
-                print_warnings=False,
-            )
+            client = LeanLSPClient(lean_project_path_obj, initial_build=True)
 
         logger.info("Built project and re-started LSP client")
 
@@ -265,7 +261,7 @@ def goal(ctx: Context, file_path: str, line: int, column: Optional[int] = None)
 
     else:
         goal = client.get_goal(rel_path, line - 1, column - 1)
-        f_goal = format_goal(goal, f"Not a valid goal position. Try elsewhere?")
+        f_goal = format_goal(goal, "Not a valid goal position. Try elsewhere?")
         f_line = format_line(content, line, column)
         return f"Goals at:\n{f_line}\n{f_goal}"
 
@@ -500,7 +496,8 @@ def multi_attempt(
             [line, 0],
         )
         # Apply the change to the file, capture diagnostics and goal state
-        diag = client.update_file(rel_path, [change])
+        client.update_file(rel_path, [change])
+        diag = client.get_diagnostics(rel_path)
         formatted_diag = "\n".join(format_diagnostics(diag, select_line=line - 1))
         goal = client.get_goal(rel_path, line - 1, len(snippet))
         formatted_goal = format_goal(goal, "Missing goal")
@@ -529,10 +526,10 @@ def run_code(ctx: Context, code: str) -> List[str] | str:
         return "No valid Lean project path found. Run another tool (e.g. `lean_diagnostic_messages`) first to set it up or set the LEAN_PROJECT_PATH environment variable."
 
     rel_path = "temp_snippet.lean"
-    abs_path = os.path.join(lean_project_path, rel_path)
+    abs_path = lean_project_path / rel_path
 
     try:
-        with open(abs_path, "w") as f:
+        with open(abs_path, "w", encoding="utf-8") as f:
             f.write(code)
     except Exception as e:
         return f"Error writing code snippet to file `{abs_path}`:\n{str(e)}"

lean_lsp_mcp/utils.py

@@ -16,7 +16,9 @@ class OutputCapture:
         self.captured_output = ""
 
     def __enter__(self):
-        self.temp_file = tempfile.NamedTemporaryFile(mode="w+", delete=False)
+        self.temp_file = tempfile.NamedTemporaryFile(
+            mode="w+", delete=False, encoding="utf-8"
+        )
         self.original_stdout_fd = os.dup(sys.stdout.fileno())
         self.original_stderr_fd = os.dup(sys.stderr.fileno())
         os.dup2(self.temp_file.fileno(), sys.stdout.fileno())

{lean_lsp_mcp-0.9.1.dist-info → lean_lsp_mcp-0.10.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lean-lsp-mcp
-Version: 0.9.1
+Version: 0.10.1
 Summary: Lean Theorem Prover MCP
 Author-email: Oliver Dressler <hey@oli.show>
 License-Expression: MIT
@@ -8,8 +8,8 @@ Project-URL: Repository, https://github.com/oOo0oOo/lean-lsp-mcp
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: leanclient==0.2.1
-Requires-Dist: mcp[cli]==1.17.0
+Requires-Dist: leanclient==0.3.0
+Requires-Dist: mcp[cli]==1.18.0
 Requires-Dist: orjson>=3.11.1
 Provides-Extra: lint
 Requires-Dist: ruff>=0.2.0; extra == "lint"
@@ -40,8 +40,6 @@ Dynamic: license-file
 
 MCP server that allows agentic interaction with the [Lean theorem prover](https://lean-lang.org/) via the [Language Server Protocol](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/) using [leanclient](https://github.com/oOo0oOo/leanclient). This server provides a range of tools for LLM agents to understand, analyze and interact with Lean projects.
 
-**Currently beta testing**: Please help us by submitting bug reports and feature requests!
-
 ## Key Features
 
 * **Rich Lean Interaction**: Access diagnostics, goal states, term information, hover documentation and more.
@@ -59,31 +57,17 @@ MCP server that allows agentic interaction with the [Lean theorem prover](https:
 
 ### 1. Install uv
 
-[Install uv](https://docs.astral.sh/uv/getting-started/installation/) for your system.
-
-E.g. on Linux/MacOS:
-
-```bash
-curl -LsSf https://astral.sh/uv/install.sh | sh
-```
+[Install uv](https://docs.astral.sh/uv/getting-started/installation/) for your system. On Linux/MacOS: `curl -LsSf https://astral.sh/uv/install.sh | sh`
 
 ### 2. Run `lake build`
 
-`lean-lsp-mcp` will run `lake build` in the project root to use the language server (for most tools). Some clients (e.g. Cursor) might timeout during this process. Therefore, it is recommended to run `lake build` manually before starting the MCP. This ensures a faster build time and avoids timeouts.
-
-E.g. on Linux/MacOS:
-```bash
-cd /path/to/lean/project
-lake build
-```
-
-Note: Your build does not necessarily need to be successful, some errors or warnings (e.g. `declaration uses 'sorry'`) are OK.
+`lean-lsp-mcp` will run `lake serve` in the project root to use the language server (for most tools). Some clients (e.g. Cursor) might timeout during this process. Therefore, it is recommended to run `lake build` manually before starting the MCP. This ensures a faster build time and avoids timeouts.
 
-### 3. a) VSCode Setup
+### 3. Configure your IDE/Setup
 
-VSCode and VSCode Insiders are supporting MCPs in [agent mode](https://code.visualstudio.com/blogs/2025/04/07/agentMode). For VSCode you might have to enable `Chat > Agent: Enable` in the settings.
-
-1. One-click config setup:
+<details>
+<summary><b>VSCode</b></summary>
+One-click config setup:
 
 [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=lean-lsp&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22lean-lsp-mcp%22%5D%7D)
 
@@ -108,11 +92,10 @@ OR manually add config to `mcp.json`:
     }
 }
 ```
+</details>
 
-2. Click "Start" above server config, open a Lean file, change to agent mode in the chat and run e.g. "auto proof" to get started.
-
-### 3. b) Cursor Setup
-
+<details>
+<summary><b>Cursor</b></summary>
 1. Open MCP Settings (File > Preferences > Cursor Settings > MCP)
 
 2. "+ Add a new global MCP Server" > ("Create File")
@@ -129,9 +112,10 @@ OR manually add config to `mcp.json`:
     }
 }
 ```
+</details>
 
-### 3. c) Claude Code
-
+<details>
+<summary><b>Claude Code</b></summary>
 Run one of these commands in the root directory of your Lean project (where `lakefile.toml` is located):
 
 ```bash
@@ -146,79 +130,18 @@ claude mcp add lean-lsp uvx lean-lsp-mcp -e LEAN_PROJECT_PATH=$PWD
 ```
 
 You can find more details about MCP server configuration for Claude Code [here](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#configure-mcp-servers).
+</details>
 
-### Other Setups
+#### Claude Skill: Lean4 Theorem Proving
 
-Other setups, such as [Claude Desktop](https://modelcontextprotocol.io/quickstart/user), [OpenAI Agent SDK](https://openai.github.io/openai-agents-python/mcp/), [Windsurf](https://docs.windsurf.com/windsurf/cascade/mcp) or [Goose](https://block.github.io/goose/docs/getting-started/using-extensions) should work with similar configs.
+If you are using [Claude Desktop](https://modelcontextprotocol.io/quickstart/user) or [Claude Code](https://claude.ai/code), you can also install the [Lean4 Theorem Proving Skill](https://github.com/cameronfreer/lean4-skills/tree/main/lean4-theorem-proving). This skill provides additional prompts and templates for interacting with Lean4 projects and includes a section on interacting with the `lean-lsp-mcp` server.
 
 ### 4. Install ripgrep (optional but recommended)
 
-For the local search tool `lean_local_search`, please install [ripgrep](https://github.com/BurntSushi/ripgrep?tab=readme-ov-file#installation) (`rg`) and make sure it is available in your PATH.
-
-### Transport Methods
-
-The Lean LSP MCP server supports the following transport methods:
-
-- `stdio`: Standard input/output (default)
-- `streamable-http`: HTTP streaming
-- `sse`: Server-sent events (MCP legacy, use `streamable-http` if possible)
-
-You can specify the transport method using the `--transport` argument when running the server. For `sse` and `streamable-http` you can also optionally specify the host and port:
-
-```bash
-uvx lean-lsp-mcp --transport stdio # Default transport
-uvx lean-lsp-mcp --transport streamable-http # Available at http://127.0.0.1:8000/mcp
-uvx lean-lsp-mcp --transport sse --host localhost --port 12345 # Available at http://localhost:12345/sse
-```
-
-### Bearer Token Authentication
-
-Transport via `streamable-http` and `sse` supports bearer token authentication. This allows publicly accessible MCP servers to restrict access to authorized clients.
-
-Set the `LEAN_LSP_MCP_TOKEN` environment variable (or see section 3 for setting env variables in MCP config) to a secret token before starting the server.
-
-Example Linux/MacOS setup:
-
-```bash
-export LEAN_LSP_MCP_TOKEN="your_secret_token"
-uvx lean-lsp-mcp --transport streamable-http
-```
-
-Clients should then include the token in the `Authorization` header.
-
-### Environment Variables
-
-Some (optional) features and integrations of `lean-lsp-mcp` are configured using environment variables. These must be set in your shell or process environment before running the server.
-
-- `LEAN_PROJECT_PATH`: (optional) Path to your Lean project root. Set this if the server cannot automatically detect your project.
-- `LEAN_LOG_LEVEL`: (optional) Log level for the server. Options are "INFO", "WARNING", "ERROR", "NONE". Defaults to "INFO".
-- `LEAN_LSP_MCP_TOKEN`: (optional) Secret token for bearer authentication when using `streamable-http` or `sse` transport.
-- `LEAN_STATE_SEARCH_URL`: (optional) URL for a self-hosted [premise-search.com](https://premise-search.com) instance.
-- `LEAN_HAMMER_URL`: (optional) URL for a self-hosted [Lean Hammer Premise Search](https://github.com/hanwenzhu/lean-premise-server) instance.
-
-You can also often set these environment variables in your MCP client configuration:
-
-```jsonc
-{
-    "servers": {
-        "lean-lsp": {
-            "type": "stdio",
-            "command": "uvx",
-            "args": [
-                "lean-lsp-mcp"
-            ],
-            "env": {
-                "LEAN_PROJECT_PATH": "/path/to/your/lean/project",
-                "LEAN_LOG_LEVEL": "NONE"
-            }
-        }
-    }
-}
-```
+For the local search tool `lean_local_search`, install [ripgrep](https://github.com/BurntSushi/ripgrep?tab=readme-ov-file#installation) (`rg`) and make sure it is available in your PATH.
 
-## Tools
+## MCP Tools
 
-Tools are currently the only way to interact with the MCP server.
 
 ### File interactions (LSP)
 
@@ -233,16 +156,18 @@ Get all diagnostic messages for a Lean file. This includes infos, warnings and e
 <details>
 <summary>Example output</summary>
 
-l20c42-l20c46, severity: 1<br>
+```
+l20c42-l20c46, severity: 1
 simp made no progress
 
-l21c11-l21c45, severity: 1<br>
+l21c11-l21c45, severity: 1
 function expected at
   h_empty
 term has type
   T ∩ compl T = ∅
 
 ...
+```
 </details>
 
 #### lean_goal
@@ -251,21 +176,24 @@ Get the proof goal at a specific location (line or line & column) in a Lean file
 
 <details>
 <summary>Example output (line)</summary>
-Before:<br>
-S : Type u_1<br>
-inst✝¹ : Fintype S<br>
-inst✝ : Nonempty S<br>
-P : Finset (Set S)<br>
-hPP : ∀ T ∈ P, ∀ U ∈ P, T ∩ U ≠ ∅<br>
-hPS : ¬∃ T ∉ P, ∀ U ∈ P, T ∩ U ≠ ∅<br>
-compl : Set S → Set S := fun T ↦ univ \ T<br>
-hcompl : ∀ T ∈ P, compl T ∉ P<br>
-all_subsets : Finset (Set S) := Finset.univ<br>
-h_comp_in_P : ∀ T ∉ P, compl T ∈ P<br>
-h_partition : ∀ (T : Set S), T ∈ P ∨ compl T ∈ P<br>
-⊢ P.card = 2 ^ (Fintype.card S - 1)<br>
-After:<br>
+
+```
+Before:
+S : Type u_1
+inst✝¹ : Fintype S
+inst✝ : Nonempty S
+P : Finset (Set S)
+hPP : ∀ T ∈ P, ∀ U ∈ P, T ∩ U ≠ ∅
+hPS : ¬∃ T ∉ P, ∀ U ∈ P, T ∩ U ≠ ∅
+compl : Set S → Set S := fun T ↦ univ \ T
+hcompl : ∀ T ∈ P, compl T ∉ P
+all_subsets : Finset (Set S) := Finset.univ
+h_comp_in_P : ∀ T ∉ P, compl T ∈ P
+h_partition : ∀ (T : Set S), T ∈ P ∨ compl T ∈ P
+⊢ P.card = 2 ^ (Fintype.card S - 1)
+After:
 no goals
+```
 </details>
 
 #### lean_term_goal
@@ -278,13 +206,16 @@ Retrieve hover information (documentation) for symbols, terms, and expressions i
 
 <details>
 <summary>Example output (hover info on a `sorry`)</summary>
-The `sorry` tactic is a temporary placeholder for an incomplete tactic proof,<br>
-closing the main goal using `exact sorry`.<br><br>
 
-This is intended for stubbing-out incomplete parts of a proof while still having a syntactically correct proof skeleton.<br>
-Lean will give a warning whenever a proof uses `sorry`, so you aren't likely to miss it,<br>
-but you can double check if a theorem depends on `sorry` by looking for `sorryAx` in the output<br>
-of the `#print axioms my_thm` command, the axiom used by the implementation of `sorry`.<br>
+```
+The `sorry` tactic is a temporary placeholder for an incomplete tactic proof,
+closing the main goal using `exact sorry`.
+
+This is intended for stubbing-out incomplete parts of a proof while still having a syntactically correct proof skeleton.
+Lean will give a warning whenever a proof uses `sorry`, so you aren't likely to miss it,
+but you can double check if a theorem depends on `sorry` by looking for `sorryAx` in the output
+of the `#print axioms my_thm` command, the axiom used by the implementation of `sorry`.
+```
 </details>
 
 #### lean_declaration_file
@@ -300,8 +231,11 @@ Code auto-completion: Find available identifiers or import suggestions at a spec
 Run/compile an independent Lean code snippet/file and return the result or error message.
 <details>
 <summary>Example output (code snippet: `#eval 5 * 7 + 3`)</summary>
-l1c1-l1c6, severity: 3<br>
+
+```
+l1c1-l1c6, severity: 3
 38
+```
 </details>
 
 #### lean_multi_attempt
@@ -311,29 +245,32 @@ This tool is useful to screen different proof attempts before using the most pro
 
 <details>
 <summary>Example output (attempting `rw [Nat.pow_sub (Fintype.card_pos_of_nonempty S)]` and `by_contra h_neq`)</summary>
-  rw [Nat.pow_sub (Fintype.card_pos_of_nonempty S)]:<br>
-S : Type u_1<br>
-inst✝¹ : Fintype S<br>
-inst✝ : Nonempty S<br>
-P : Finset (Set S)<br>
-hPP : ∀ T ∈ P, ∀ U ∈ P, T ∩ U ≠ ∅<br>
-hPS : ¬∃ T ∉ P, ∀ U ∈ P, T ∩ U ≠ ∅<br>
-⊢ P.card = 2 ^ (Fintype.card S - 1)<br>
-<br>
-l14c7-l14c51, severity: 1<br>
-unknown constant 'Nat.pow_sub'<br>
-<br>
-  by_contra h_neq:<br>
- S : Type u_1<br>
-inst✝¹ : Fintype S<br>
-inst✝ : Nonempty S<br>
-P : Finset (Set S)<br>
-hPP : ∀ T ∈ P, ∀ U ∈ P, T ∩ U ≠ ∅<br>
-hPS : ¬∃ T ∉ P, ∀ U ∈ P, T ∩ U ≠ ∅<br>
-h_neq : ¬P.card = 2 ^ (Fintype.card S - 1)<br>
-⊢ False<br>
-<br>
+
+```
+  rw [Nat.pow_sub (Fintype.card_pos_of_nonempty S)]:
+S : Type u_1
+inst✝¹ : Fintype S
+inst✝ : Nonempty S
+P : Finset (Set S)
+hPP : ∀ T ∈ P, ∀ U ∈ P, T ∩ U ≠ ∅
+hPS : ¬∃ T ∉ P, ∀ U ∈ P, T ∩ U ≠ ∅
+⊢ P.card = 2 ^ (Fintype.card S - 1)
+
+l14c7-l14c51, severity: 1
+unknown constant 'Nat.pow_sub'
+
+  by_contra h_neq:
+ S : Type u_1
+inst✝¹ : Fintype S
+inst✝ : Nonempty S
+P : Finset (Set S)
+hPP : ∀ T ∈ P, ∀ U ∈ P, T ∩ U ≠ ∅
+hPS : ¬∃ T ∉ P, ∀ U ∈ P, T ∩ U ≠ ∅
+h_neq : ¬P.card = 2 ^ (Fintype.card S - 1)
+⊢ False
+
 ...
+```
 </details>
 
 ### Local Search Tools
@@ -347,7 +284,7 @@ This tool requires [ripgrep](https://github.com/BurntSushi/ripgrep?tab=readme-ov
 
 ### External Search Tools
 
-Currently all external tools are **rate limited to 3 requests per 30 seconds**. This will change based on provider feedback.
+Currently all external tools are separately **rate limited to 3 requests per 30 seconds**.
 
 #### lean_leansearch
 
@@ -455,7 +392,7 @@ Note: We use a simplified version, [LeanHammer](https://github.com/JOSHCLUNE/Lea
 
 Rebuild the Lean project and restart the Lean LSP server.
 
-## Disabling Tools
+### Disabling Tools
 
 Many clients allow the user to disable specific tools manually (e.g. lean_build).
 
@@ -463,32 +400,71 @@ Many clients allow the user to disable specific tools manually (e.g. lean_build)
 
 **Cursor**: In "Cursor Settings" > "MCP" click on the name of a tool to disable it (strikethrough).
 
-## Example Uses
+## MCP Configuration
+
+This MCP server works out-of-the-box without any configuration. However, a few optional settings are available.
+
+### Environment Variables
+
+- `LEAN_LOG_LEVEL`: Log level for the server. Options are "INFO", "WARNING", "ERROR", "NONE". Defaults to "INFO".
+- `LEAN_PROJECT_PATH`: Path to your Lean project root. Set this if the server cannot automatically detect your project.
+- `LEAN_LSP_MCP_TOKEN`: Secret token for bearer authentication when using `streamable-http` or `sse` transport.
+- `LEAN_STATE_SEARCH_URL`: URL for a self-hosted [premise-search.com](https://premise-search.com) instance.
+- `LEAN_HAMMER_URL`: URL for a self-hosted [Lean Hammer Premise Search](https://github.com/hanwenzhu/lean-premise-server) instance.
+
+You can also often set these environment variables in your MCP client configuration:
+<details>
+<summary><b>VSCode mcp.json Example</b></summary>
+
+```jsonc
+{
+    "servers": {
+        "lean-lsp": {
+            "type": "stdio",
+            "command": "uvx",
+            "args": [
+                "lean-lsp-mcp"
+            ],
+            "env": {
+                "LEAN_PROJECT_PATH": "/path/to/your/lean/project",
+                "LEAN_LOG_LEVEL": "NONE"
+            }
+        }
+    }
+}
+```
+</details>
 
-Here are a few example prompts and interactions to try. All examples use VSCode (Agent Mode) and Gemini 2.5 Pro (Preview).
+### Transport Methods
 
-### Use tools to assist with a proof
+The Lean LSP MCP server supports the following transport methods:
 
-After installing the MCP, tools are **automatically available** to the agent.
-E.g. Open a Lean file with a sorry and run the following prompt: "Solve this sorry"
-The agent should use various tools such as `lean_goal` to understand and create a proof.
-You can also ask the agent to use tools explicitly, e.g. "Help me write this proof using tools." or "Use tools to analyze the goal and hover information, then write a proof."
+- `stdio`: Standard input/output (default)
+- `streamable-http`: HTTP streaming
+- `sse`: Server-sent events (MCP legacy, use `streamable-http` if possible)
 
-### Analyze a theorem
+You can specify the transport method using the `--transport` argument when running the server. For `sse` and `streamable-http` you can also optionally specify the host and port:
 
-Open `Algebra/Lie/Abelian.lean`. Example prompt:
+```bash
+uvx lean-lsp-mcp --transport stdio # Default transport
+uvx lean-lsp-mcp --transport streamable-http # Available at http://127.0.0.1:8000/mcp
+uvx lean-lsp-mcp --transport sse --host localhost --port 12345 # Available at http://localhost:12345/sse
+```
 
-"Analyze commutative_ring_iff_abelian_lie_ring thoroughly using various tools such as goal, term goal, hover info. Explain the key proof steps in english.".
+### Bearer Token Authentication
 
-![Analyzing a theorem in chat](media/analyze_theorem.png)
+Transport via `streamable-http` and `sse` supports bearer token authentication. This allows publicly accessible MCP servers to restrict access to authorized clients.
 
-### Design proof approaches
+Set the `LEAN_LSP_MCP_TOKEN` environment variable (or see section 3 for setting env variables in MCP config) to a secret token before starting the server.
 
-Open an incomplete proof such as [putnam 1964 b2](https://github.com/trishullab/PutnamBench/blob/main/lean4/src/putnam_1964_b2.lean). Example prompt:
+Example Linux/MacOS setup:
 
-"First analyze the problem statement by checking the goal, hover info and looking up key declarations. Next use up to three queries to leansearch to design three different approaches to solve this problem. Very concisely present each approach and its key challenge."
+```bash
+export LEAN_LSP_MCP_TOKEN="your_secret_token"
+uvx lean-lsp-mcp --transport streamable-http
+```
 
-![Designing proof approaches](media/proof_approaches.png)
+Clients should then include the token in the `Authorization` header.
 
 ## Notes on MCP Security
 
@@ -503,13 +479,15 @@ Please be aware of these risks. Feel free to audit the code and report security
 
 For more information, you can use [Awesome MCP Security](https://github.com/Puliczek/awesome-mcp-security) as a starting point.
 
-## MCP Inspector
+## Development
+
+### MCP Inspector
 
 ```bash
 npx @modelcontextprotocol/inspector uvx --with-editable path/to/lean-lsp-mcp python -m lean_lsp_mcp.server
 ```
 
-## Run Tests
+### Run Tests
 
 ```bash
 uv sync --all-extras

lean_lsp_mcp-0.10.1.dist-info/RECORD

@@ -0,0 +1,14 @@
+lean_lsp_mcp/__init__.py,sha256=lxqDq0G_sI2iu2Nniy-pTW7BE9Ux7ZXeDoGf0OAWIDc,763
+lean_lsp_mcp/__main__.py,sha256=XnpTzfJc0T-j9tHtdkA8ovTr1c139ffTewcJGhxYDaM,49
+lean_lsp_mcp/client_utils.py,sha256=mN0wQlGLMVR8bV0OqVJ8YHq6vUoty4MzebvA9A3u4dM,3502
+lean_lsp_mcp/file_utils.py,sha256=6dVceZOCb28KsKtoub4QPD272TrtKzFZedg4H-N6KgA,2926
+lean_lsp_mcp/instructions.py,sha256=qdGW1Qh14Gb_ezrMLU_SrS_F1X_r065KIsQu0HamwnU,825
+lean_lsp_mcp/search_utils.py,sha256=cNpWzR1TuNyvRxCeCIb0HoEHGsCIW1ypqN1R1ZpbkdI,4170
+lean_lsp_mcp/server.py,sha256=su-e52pgsczlFJWrGiUOWsGjlZ3wsv3txhH1u3pirOI,27995
+lean_lsp_mcp/utils.py,sha256=8wqjD5gfZhIkM1vLxvLoDkh-RQx_kDrxdRRUb1VQAbI,6040
+lean_lsp_mcp-0.10.1.dist-info/licenses/LICENSE,sha256=CQlxnf0tQyoVrBE93JYvAUYxv6Z5Yg6sX0pwogOkFvo,1071
+lean_lsp_mcp-0.10.1.dist-info/METADATA,sha256=GagjAFqDoOntIJcazBaj_mJE4-d4em5jOaY4FLe4HC0,17455
+lean_lsp_mcp-0.10.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+lean_lsp_mcp-0.10.1.dist-info/entry_points.txt,sha256=nQbvwctWkWD7I-2f4VrdVQBZYGUw8CnUnFC6QjXxOSE,51
+lean_lsp_mcp-0.10.1.dist-info/top_level.txt,sha256=LGEK0lgMSNPIQ6mG8EO-adaZEGPi_0daDs004epOTF0,13
+lean_lsp_mcp-0.10.1.dist-info/RECORD,,

lean_lsp_mcp-0.9.1.dist-info/RECORD

@@ -1,14 +0,0 @@
-lean_lsp_mcp/__init__.py,sha256=lxqDq0G_sI2iu2Nniy-pTW7BE9Ux7ZXeDoGf0OAWIDc,763
-lean_lsp_mcp/__main__.py,sha256=XnpTzfJc0T-j9tHtdkA8ovTr1c139ffTewcJGhxYDaM,49
-lean_lsp_mcp/client_utils.py,sha256=Nwo6aA7cilFMYt7wM_PhhEpokuazU4g6GZEeNz_HqDQ,3329
-lean_lsp_mcp/file_utils.py,sha256=mGp8ASeSpKofzETFbCrq8XwGRwv9Z-JrvsWLxdGJiFU,2742
-lean_lsp_mcp/instructions.py,sha256=qdGW1Qh14Gb_ezrMLU_SrS_F1X_r065KIsQu0HamwnU,825
-lean_lsp_mcp/search_utils.py,sha256=cNpWzR1TuNyvRxCeCIb0HoEHGsCIW1ypqN1R1ZpbkdI,4170
-lean_lsp_mcp/server.py,sha256=Zjg2zk-F-b5LCgaobafczlRCIRFmaY5OkuDNIegSCEM,28004
-lean_lsp_mcp/utils.py,sha256=KoA2L0SswQQSdv_F1hS8xPwVdL8Tzuke9xSXB_RpsTo,6000
-lean_lsp_mcp-0.9.1.dist-info/licenses/LICENSE,sha256=CQlxnf0tQyoVrBE93JYvAUYxv6Z5Yg6sX0pwogOkFvo,1071
-lean_lsp_mcp-0.9.1.dist-info/METADATA,sha256=j2dt6XJYLnLKqE3w2O4Vs3x9OVQq_q2Y3sCQm5odKNQ,19521
-lean_lsp_mcp-0.9.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-lean_lsp_mcp-0.9.1.dist-info/entry_points.txt,sha256=nQbvwctWkWD7I-2f4VrdVQBZYGUw8CnUnFC6QjXxOSE,51
-lean_lsp_mcp-0.9.1.dist-info/top_level.txt,sha256=LGEK0lgMSNPIQ6mG8EO-adaZEGPi_0daDs004epOTF0,13
-lean_lsp_mcp-0.9.1.dist-info/RECORD,,