pathgate 0.2.2__tar.gz → 0.2.4__tar.gz

{pathgate-0.2.2 → pathgate-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pathgate
-Version: 0.2.2
+Version: 0.2.4
 Summary: Filesystem MCP server with allow-listed directories
 License: MIT
 License-File: LICENSE
@@ -8,6 +8,8 @@ Requires-Python: >=3.10
 Requires-Dist: mcp<3,>=2
 Description-Content-Type: text/markdown
 
+<!-- mcp-name: io.github.geekgod382/pathgate -->
+
 # Pathgate 
 
 `pathgate` is a Python Model Context Protocol (MCP) server that exposes a controlled filesystem interface to MCP clients such as Claude Desktop, Cursor, VS Code, and inspector tools. The server only permits access to directories that are explicitly allow-listed at startup.
@@ -31,14 +33,14 @@ Access is restricted by allow-listed paths. At startup, the server resolves the
 
 ## Installation
 
-Pathgate package is published on PyPI. To use it, for example with Claude Desktop, add this in the 
+Pathgate package is published on PyPI. To use it, for example with Claude Desktop, add this in the claude_desktop_config.json
 
 ```json
 {
   "mcpServers": {
     "pathgate": {
       "command": "uvx",
-      "args": ["pathgate", "C:\\Users\\me\\Documents"]
+      "args": ["pathgate@latest", "C:\\Users\\me\\Documents"]
     }
   }
 }
@@ -50,7 +52,7 @@ Or, you can use the install command to directly write the config file
 uvx pathgate install <paths>
 ```
 
-paths should have nothing between them
+Paths should be separated by spaces
 
 ```bash
 uvx pathgate install C:\Users\me\Documents C:\Users\me\Projects
@@ -60,31 +62,35 @@ When no paths are given, it prompts you for them.
 
 ### Options
 
-`--read-only:` writes the safer variant of the entry.
-`--dry-run`: shows what it would write and changes nothing.
-`--yes`: skips the confirmation prompt.
-`--name`: sets a different entry name (default pathgate).
-`--config PATH`: I build this mcp server for Claude primarily. Using this option edits a specific file, which also works for other clients that use the same mcpServers shape.
+- `--read-only:` writes the safer variant of the entry.
+- `--dry-run`: shows what it would write and changes nothing.
+- `--yes`: skips the confirmation prompt.
+- `--name`: sets a different entry name (default pathgate).
+- `--config PATH`: I build this mcp server for Claude primarily. Using this option edits a specific file, which also works for other clients that use the same mcpServers shape.
+
+### Updating
+
+You don't need to manually update it. The command does that for you.
 
 ## Usage
 
 ### Start with allowed directories
 
 ```bash
-pathgate "C:\Users\<username>\Documents" "C:\Users\<username>\Projects"
+uvx pathgate "C:\Users\<username>\Documents" "C:\Users\<username>\Projects"
 ```
 
 ### Read-only mode
 
 ```bash
-pathgate --read-only "C:\Users\<username>\Documents"
+uvx pathgate --read-only "C:\Users\<username>\Documents"
 ```
 
 ### Environment variable alternative
 
 ```bash
 $env:FS_MCP_ALLOWED_PATHS = "C:\Users\<username>\Documents;C:\Users\<username>\Projects"
-pathgate
+uvx pathgate
 ```
 
 On macOS/Linux, use `:` instead of `;` for the path separator.
@@ -133,6 +139,7 @@ pathgate/
 │   ├── __init__.py
 │   ├── __main__.py
 │   ├── config.py
+│   ├── install.py
 │   ├── prompts.py
 │   ├── resources.py
 │   ├── server.py

{pathgate-0.2.2 → pathgate-0.2.4}/README.md

@@ -1,3 +1,5 @@
+<!-- mcp-name: io.github.geekgod382/pathgate -->
+
 # Pathgate 
 
 `pathgate` is a Python Model Context Protocol (MCP) server that exposes a controlled filesystem interface to MCP clients such as Claude Desktop, Cursor, VS Code, and inspector tools. The server only permits access to directories that are explicitly allow-listed at startup.
@@ -21,14 +23,14 @@ Access is restricted by allow-listed paths. At startup, the server resolves the
 
 ## Installation
 
-Pathgate package is published on PyPI. To use it, for example with Claude Desktop, add this in the 
+Pathgate package is published on PyPI. To use it, for example with Claude Desktop, add this in the claude_desktop_config.json
 
 ```json
 {
   "mcpServers": {
     "pathgate": {
       "command": "uvx",
-      "args": ["pathgate", "C:\\Users\\me\\Documents"]
+      "args": ["pathgate@latest", "C:\\Users\\me\\Documents"]
     }
   }
 }
@@ -40,7 +42,7 @@ Or, you can use the install command to directly write the config file
 uvx pathgate install <paths>
 ```
 
-paths should have nothing between them
+Paths should be separated by spaces
 
 ```bash
 uvx pathgate install C:\Users\me\Documents C:\Users\me\Projects
@@ -50,31 +52,35 @@ When no paths are given, it prompts you for them.
 
 ### Options
 
-`--read-only:` writes the safer variant of the entry.
-`--dry-run`: shows what it would write and changes nothing.
-`--yes`: skips the confirmation prompt.
-`--name`: sets a different entry name (default pathgate).
-`--config PATH`: I build this mcp server for Claude primarily. Using this option edits a specific file, which also works for other clients that use the same mcpServers shape.
+- `--read-only:` writes the safer variant of the entry.
+- `--dry-run`: shows what it would write and changes nothing.
+- `--yes`: skips the confirmation prompt.
+- `--name`: sets a different entry name (default pathgate).
+- `--config PATH`: I build this mcp server for Claude primarily. Using this option edits a specific file, which also works for other clients that use the same mcpServers shape.
+
+### Updating
+
+You don't need to manually update it. The command does that for you.
 
 ## Usage
 
 ### Start with allowed directories
 
 ```bash
-pathgate "C:\Users\<username>\Documents" "C:\Users\<username>\Projects"
+uvx pathgate "C:\Users\<username>\Documents" "C:\Users\<username>\Projects"
 ```
 
 ### Read-only mode
 
 ```bash
-pathgate --read-only "C:\Users\<username>\Documents"
+uvx pathgate --read-only "C:\Users\<username>\Documents"
 ```
 
 ### Environment variable alternative
 
 ```bash
 $env:FS_MCP_ALLOWED_PATHS = "C:\Users\<username>\Documents;C:\Users\<username>\Projects"
-pathgate
+uvx pathgate
 ```
 
 On macOS/Linux, use `:` instead of `;` for the path separator.
@@ -123,6 +129,7 @@ pathgate/
 │   ├── __init__.py
 │   ├── __main__.py
 │   ├── config.py
+│   ├── install.py
 │   ├── prompts.py
 │   ├── resources.py
 │   ├── server.py

{pathgate-0.2.2 → pathgate-0.2.4}/pathgate/install.py

@@ -80,15 +80,19 @@ def resolve_config_path(explicit: str | None) -> Path:
 # --------------------------------------------------------------------------
 
 def build_server_entry(paths: list[str], read_only: bool) -> dict:
-    """The `mcpServers` entry that launches Pathgate."""
+    """The `mcpServers` entry that launches Pathgate.
+
+    `pathgate@latest` makes uv check PyPI on every launch, so users always
+    run the newest release without doing anything.
+    """
     uvx = shutil.which("uvx")
     uv = shutil.which("uv")
     if uvx:
-        command, args = uvx, ["pathgate"]
+        command, args = uvx, ["pathgate@latest"]
     elif uv:
-        command, args = uv, ["tool", "run", "pathgate"]
+        command, args = uv, ["tool", "run", "pathgate@latest"]
     else:
-        command, args = sys.executable, ["-m", "pathgate"]
+        command, args = sys.executable, ["-m", "pathgate"]  # no uv: can't auto-update
     args = args + paths
     if read_only:
         args.append("--read-only")

{pathgate-0.2.2 → pathgate-0.2.4}/pathgate/server.py

@@ -38,6 +38,7 @@ def parse_args(argv=None):
     )
     p.add_argument("paths", nargs="*", help="Directories the server may access")
     p.add_argument("--read-only", action="store_true", help="Disable write/delete/move/copy tools")
+    p.add_argument("--version", action="version", version=f"pathgate {_version()}")
     args = p.parse_args(argv)
 
     env_paths = [x for x in os.environ.get("FS_MCP_ALLOWED_PATHS", "").split(os.pathsep) if x]

{pathgate-0.2.2 → pathgate-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pathgate"
-version = "0.2.2"
+version = "0.2.4"
 description = "Filesystem MCP server with allow-listed directories"
 readme = "README.md"
 requires-python = ">=3.10"