sqlnow-mcp 0.2.1__tar.gz → 0.3.0__tar.gz

{sqlnow_mcp-0.2.1 → sqlnow_mcp-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlnow-mcp
-Version: 0.2.1
+Version: 0.3.0
 Summary: MCP server for DuckDB with interactive table viewer
 Keywords: mcp,duckdb,sql,llm,claude,cursor
 Author: David Raznick
@@ -19,6 +19,8 @@ Classifier: Topic :: Scientific/Engineering
 Requires-Dist: click
 Requires-Dist: duckdb
 Requires-Dist: fastmcp
+Requires-Dist: flatterer>=0.24.1
+Requires-Dist: openpyxl
 Requires-Dist: pyarrow
 Requires-Dist: pytz
 Requires-Dist: pyyaml

{sqlnow_mcp-0.2.1 → sqlnow_mcp-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sqlnow-mcp"
-version = "0.2.1"
+version = "0.3.0"
 description = "MCP server for DuckDB with interactive table viewer"
 readme = "README.md"
 license = "MIT"
@@ -25,6 +25,8 @@ dependencies = [
     "click",
     "duckdb",
     "fastmcp",
+    "flatterer>=0.24.1",
+    "openpyxl",
     "pyarrow",
     "pytz",
     "pyyaml",
@@ -38,6 +40,7 @@ Issues = "https://github.com/kindly/sqlnow-mcp/issues"
 
 [project.scripts]
 sqlnow-mcp = "sqlnow_mcp:main"
+xlsx2duckdb = "sqlnow_mcp.xlsx2duckdb.cli:main"
 
 [dependency-groups]
 dev = [

{sqlnow_mcp-0.2.1 → sqlnow_mcp-0.3.0}/sqlnow_mcp/cli.py

@@ -98,10 +98,19 @@ def _make_session(
     show_default=True,
     help="MCP transport for local and publish (stdio spawns process; others listen on --host/--port).",
 )
+@click.option(
+    "--read-only/--read-write",
+    "read_only",
+    default=False,
+    show_default=True,
+    help="Local mode: strict read-only. Forbids writes/attach/detach (the shared "
+    "connection is never reopened). Without it, local mode is "
+    "read-only-with-temporary-writes (mutations briefly swap the connection).",
+)
 @click.option(
     "--database",
     "-d",
-    help="Active database name (without .db extension).",
+    help="Active database name (with or without the .db/.duckdb extension).",
 )
 @click.option(
     "--db",
@@ -162,6 +171,7 @@ def cli(
     host: str,
     port: int,
     transport: str,
+    read_only: bool,
     database: str | None,
     publish_db: Path | None,
     metadata_path: Path | None,
@@ -211,6 +221,8 @@ def cli(
                 host=host,
                 port=port,
                 transport=transport.lower(),  # type: ignore[arg-type]
+                read_only=read_only,
+                database=database,
             )
             run_local_server(cfg)
             return
@@ -238,7 +250,7 @@ def create_database_cmd(ctx: click.Context, name: str) -> None:
 @cli.command("list-databases")
 @click.pass_context
 def list_databases(ctx: click.Context) -> None:
-    """List .db files in data-dir."""
+    """List .db and .duckdb files in data-dir."""
     session = _session_from_ctx(ctx)
     dbs = session.list_databases()
     if not dbs:
@@ -278,20 +290,35 @@ def current(ctx: click.Context) -> None:
     default="view",
     show_default=True,
 )
+@click.option(
+    "--max-cells",
+    type=int,
+    default=10_000,
+    show_default=True,
+    help="XLSX: cell budget above which a non-tabular sheet is skipped.",
+)
 @click.pass_context
 def attach_file_cmd(
     ctx: click.Context,
     path: Path,
     name: str | None,
     attach_mode: str,
+    max_cells: int,
 ) -> None:
-    """Attach a CSV or Parquet file as a view or table."""
+    """Attach a CSV, Parquet, JSON, or XLSX file as a view or table.
+
+    XLSX files import every sheet (clean sheets become typed tables; non-tabular
+    sheets become html/text content tables).
+    """
     session = _session_from_ctx(ctx)
     db = _require_database(ctx)
     _open_database(session, db)
     try:
         result = session.attach_file(
-            str(path), name=name, mode=attach_mode.lower()  # type: ignore[arg-type]
+            str(path),
+            name=name,
+            mode=attach_mode.lower(),  # type: ignore[arg-type]
+            max_cells=max_cells,
         )
     except DuckDBSessionError as exc:
         raise click.ClickException(str(exc)) from exc

{sqlnow_mcp-0.2.1 → sqlnow_mcp-0.3.0}/sqlnow_mcp/config.py

@@ -40,6 +40,12 @@ class LocalConfig:
     host: str = "127.0.0.1"
     port: int = 8000
     transport: Transport = "stdio"
+    # Strict read-only: forbid the write-swap so the shared connection is never
+    # reopened (rejects writes/attach/detach instead of swapping to read-write).
+    read_only: bool = False
+    # Database to open at startup. Lets the server reopen the same database after
+    # a restart (e.g. under an auto-reload watcher) without a fresh use_database.
+    database: str | None = None
 
 
 @dataclass(frozen=True)
@@ -64,6 +70,7 @@ def create_session(cfg: LocalConfig) -> DuckDBSession:
         data_dir=cfg.data_dir,
         allow_paths=effective,
         allow_external=cfg.allow_external,
+        allow_temp_writes=not cfg.read_only,
     )