sql-safe-mcp 1.3.0__tar.gz → 1.3.1__tar.gz

{sql_safe_mcp-1.3.0 → sql_safe_mcp-1.3.1}/CHANGELOG.md

@@ -7,6 +7,14 @@ categories `Added`, `Changed`, `Deprecated`, `Removed`, `Fixed`, and `Security`.
 
 ## [Unreleased]
 
+## [1.3.1] - 2026-09-21
+
+### Changed
+
+- A `${NAME}` placeholder embedded in `connection_url` whose value puts an encoded character into
+  the host, such as a `host:port` value whose `:` becomes `%3A`, is now a startup error that names
+  the cause. Before, the server started and every call failed after the driver's login timeout.
+
 ## [1.3.0] - 2026-09-21
 
 ### Added

{sql_safe_mcp-1.3.0 → sql_safe_mcp-1.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sql-safe-mcp
-Version: 1.3.0
+Version: 1.3.1
 Summary: Minimal, read-only, PII-safe MCP server for SQL databases.
 License: MIT License
         
@@ -137,7 +137,7 @@ or
 pip install sql-safe-mcp
 ```
 
-Pin a version when you want a fixed surface: `uvx sql-safe-mcp==1.3.0`.
+Pin a version when you want a fixed surface: `uvx sql-safe-mcp==1.3.1`.
 
 Requires Python 3.12+, [uv](https://docs.astral.sh/uv/) (or `pip`), and
 [Microsoft ODBC Driver 18 for SQL Server](https://learn.microsoft.com/sql/connect/odbc/download-odbc-driver-for-sql-server)

{sql_safe_mcp-1.3.0 → sql_safe_mcp-1.3.1}/README.md

@@ -99,7 +99,7 @@ or
 pip install sql-safe-mcp
 ```
 
-Pin a version when you want a fixed surface: `uvx sql-safe-mcp==1.3.0`.
+Pin a version when you want a fixed surface: `uvx sql-safe-mcp==1.3.1`.
 
 Requires Python 3.12+, [uv](https://docs.astral.sh/uv/) (or `pip`), and
 [Microsoft ODBC Driver 18 for SQL Server](https://learn.microsoft.com/sql/connect/odbc/download-odbc-driver-for-sql-server)

{sql_safe_mcp-1.3.0 → sql_safe_mcp-1.3.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sql-safe-mcp"
-version = "1.3.0"
+version = "1.3.1"
 description = "Minimal, read-only, PII-safe MCP server for SQL databases."
 readme = "README.md"
 requires-python = ">=3.12,<3.15"

{sql_safe_mcp-1.3.0 → sql_safe_mcp-1.3.1}/server.json

@@ -7,12 +7,12 @@
     "url": "https://github.com/proprock/sql-safe-mcp",
     "source": "github"
   },
-  "version": "1.3.0",
+  "version": "1.3.1",
   "packages": [
     {
       "registryType": "pypi",
       "identifier": "sql-safe-mcp",
-      "version": "1.3.0",
+      "version": "1.3.1",
       "transport": {
         "type": "stdio"
       }

{sql_safe_mcp-1.3.0 → sql_safe_mcp-1.3.1}/src/sql_safe_mcp/__init__.py

@@ -1,3 +1,3 @@
 """Minimal, PII-safe MCP server for relational databases."""
 
-__version__ = "1.3.0"
+__version__ = "1.3.1"

{sql_safe_mcp-1.3.0 → sql_safe_mcp-1.3.1}/src/sql_safe_mcp/config.py

@@ -75,6 +75,8 @@ class PiiConfig(BaseModel):
     rules: list[PiiRule] = Field(min_length=1)
 
 
+_PERCENT_ESCAPE = re.compile(r"%[0-9A-Fa-f]{2}")
+
 _DRIVERNAMES = {
     "sqlserver": "mssql+pyodbc",
     "mysql": "mysql+pymysql",
@@ -102,7 +104,14 @@ class ServerConfig(BaseModel):
         elif self.pii_key_env is not None or self.pii is not None:
             raise ValueError("metadata servers cannot configure pii_key_env or pii rules")
 
-        driver = make_url(self.connection_url.get_secret_value()).drivername
+        url = make_url(self.connection_url.get_secret_value())
+        if url.host and _PERCENT_ESCAPE.search(url.host):
+            raise ValueError(
+                "connection_url host contains an encoded character; a ${NAME} placeholder inside "
+                "a URL is URL-encoded, so a 'host:port' value breaks. "
+                "Use separate ${HOST} and ${PORT} variables"
+            )
+        driver = url.drivername
         expected = _DRIVERNAMES[self.engine]
         if driver != expected:
             raise ValueError(f"engine {self.engine!r} requires SQLAlchemy dialect {expected!r}")

{sql_safe_mcp-1.3.0 → sql_safe_mcp-1.3.1}/src/sql_safe_mcp/mcp_server.py

@@ -52,7 +52,7 @@ def create_server(config: AppConfig) -> MCPServer[AppContext]:
     server: MCPServer[AppContext] = MCPServer(
         "sql-safe-mcp",
         description="Minimal, read-only, PII-safe SQL database navigation.",
-        version="1.3.0",
+        version="1.3.1",
         lifespan=lifespan,
         log_level=config.logging.level,
     )