mcp-server-sqlseed 0.2.4__tar.gz → 0.2.6__tar.gz

{mcp_server_sqlseed-0.2.4 → mcp_server_sqlseed-0.2.6}/.gitignore

@@ -59,6 +59,16 @@ dmypy.json
 *.db
 *.sqlite
 *.sqlite3
+# SQLite runtime sidecars
+*.db-wal
+*.db-shm
+*.db-journal
+*.sqlite-wal
+*.sqlite-shm
+*.sqlite-journal
+*.sqlite3-wal
+*.sqlite3-shm
+*.sqlite3-journal
 .sqlseed_cache/
 snapshots/
 .env

{mcp_server_sqlseed-0.2.4 → mcp_server_sqlseed-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: mcp-server-sqlseed
-Version: 0.2.4
+Version: 0.2.6
 Summary: Offline MCP tools for sqlseed rule-driven YAML configuration and test data generation
 Project-URL: Documentation, https://sunbos.github.io/sqlseed/guide/
 Project-URL: Homepage, https://github.com/sunbos/sqlseed
@@ -17,7 +17,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.10
 Requires-Dist: mcp<2,>=1.0
-Requires-Dist: sqlseed<0.3,>=0.2.4.dev0
+Requires-Dist: sqlseed<0.3,>=0.2.5.dev0
 Description-Content-Type: text/markdown
 
 # mcp-server-sqlseed
@@ -31,13 +31,15 @@ schema, then generate test data. Both tools use offline Core rules and require n
 
 ## Installation
 
-For the 0.2.4 release, use a Python 3.10+ virtual environment:
+These instructions target version 0.2.6. Check [Releases](https://github.com/sunbos/sqlseed/releases)
+for publication status; use the source installation below to test an unpublished candidate.
+Use a Python 3.10+ virtual environment:
 
 ```bash
-python -m pip install "mcp-server-sqlseed==0.2.4"
+python -m pip install "mcp-server-sqlseed==0.2.6"
 ```
 
-Core 0.2.3 lacks the target-validation interfaces used here.
+Core 0.2.4 and older lack the shared diagnostic interfaces required by this version.
 For development, install Core and the required local plugins together from the
 repository root:
 
@@ -72,13 +74,15 @@ path. The server runs over stdio. `python -m mcp_server_sqlseed` is also support
 The `db_path` argument accepts an existing SQLite `.db`/`.sqlite`/`.sqlite3` file or a
 database URL. For PostgreSQL, install the Core `postgres` extra. Tables must already
 exist. The schema mapper chooses generators deterministically; no model request is
-made by either tool.
+made by either tool. Both tools use the required Faker provider with the `en_US`
+locale, matching the generated template; Mimesis is not required.
 
 When `yaml_config` is supplied, it must be a YAML mapping containing the requested
 table. Empty documents, unknown tables, and configurations for a different table fail
 before generation. The UTF-8 size limit is 256 KiB. Tool arguments select the database,
 table, row count, and enrichment; YAML contributes only the matching table's column
-rules, seed, and `clear_before` setting.
+rules, seed, and `clear_before` setting. Top-level YAML `provider` and `locale`
+settings do not change this server's engine or locale.
 
 A typical client workflow is:
 
@@ -97,7 +101,7 @@ schema-inspection tool are not provided. For LLM analysis, install the separate
 AI MCP extra:
 
 ```bash
-python -m pip install "sqlseed-ai[mcp]==0.2.4"
+python -m pip install "sqlseed-ai[mcp]==0.2.6"
 mcp-server-sqlseed-ai
 ```
 
@@ -108,8 +112,11 @@ Its YAML tool is
 
 ## Requirements
 
+These metadata requirements apply to version 0.2.6 and its source candidates.
+Use local Core and plugins together when developing from source.
+
 - Python `>=3.10`
-- `sqlseed>=0.2.4.dev0,<0.3`
+- `sqlseed>=0.2.5.dev0,<0.3`
 - `mcp>=1.0,<2`
 
 See the [user guide](https://sunbos.github.io/sqlseed/guide/),

{mcp_server_sqlseed-0.2.4 → mcp_server_sqlseed-0.2.6}/README.md

@@ -9,13 +9,15 @@ schema, then generate test data. Both tools use offline Core rules and require n
 
 ## Installation
 
-For the 0.2.4 release, use a Python 3.10+ virtual environment:
+These instructions target version 0.2.6. Check [Releases](https://github.com/sunbos/sqlseed/releases)
+for publication status; use the source installation below to test an unpublished candidate.
+Use a Python 3.10+ virtual environment:
 
 ```bash
-python -m pip install "mcp-server-sqlseed==0.2.4"
+python -m pip install "mcp-server-sqlseed==0.2.6"
 ```
 
-Core 0.2.3 lacks the target-validation interfaces used here.
+Core 0.2.4 and older lack the shared diagnostic interfaces required by this version.
 For development, install Core and the required local plugins together from the
 repository root:
 
@@ -50,13 +52,15 @@ path. The server runs over stdio. `python -m mcp_server_sqlseed` is also support
 The `db_path` argument accepts an existing SQLite `.db`/`.sqlite`/`.sqlite3` file or a
 database URL. For PostgreSQL, install the Core `postgres` extra. Tables must already
 exist. The schema mapper chooses generators deterministically; no model request is
-made by either tool.
+made by either tool. Both tools use the required Faker provider with the `en_US`
+locale, matching the generated template; Mimesis is not required.
 
 When `yaml_config` is supplied, it must be a YAML mapping containing the requested
 table. Empty documents, unknown tables, and configurations for a different table fail
 before generation. The UTF-8 size limit is 256 KiB. Tool arguments select the database,
 table, row count, and enrichment; YAML contributes only the matching table's column
-rules, seed, and `clear_before` setting.
+rules, seed, and `clear_before` setting. Top-level YAML `provider` and `locale`
+settings do not change this server's engine or locale.
 
 A typical client workflow is:
 
@@ -75,7 +79,7 @@ schema-inspection tool are not provided. For LLM analysis, install the separate
 AI MCP extra:
 
 ```bash
-python -m pip install "sqlseed-ai[mcp]==0.2.4"
+python -m pip install "sqlseed-ai[mcp]==0.2.6"
 mcp-server-sqlseed-ai
 ```
 
@@ -86,8 +90,11 @@ Its YAML tool is
 
 ## Requirements
 
+These metadata requirements apply to version 0.2.6 and its source candidates.
+Use local Core and plugins together when developing from source.
+
 - Python `>=3.10`
-- `sqlseed>=0.2.4.dev0,<0.3`
+- `sqlseed>=0.2.5.dev0,<0.3`
 - `mcp>=1.0,<2`
 
 See the [user guide](https://sunbos.github.io/sqlseed/guide/),

{mcp_server_sqlseed-0.2.4 → mcp_server_sqlseed-0.2.6}/README.zh-CN.md

@@ -3,19 +3,19 @@
 [English](https://github.com/sunbos/sqlseed/blob/main/plugins/mcp-server-sqlseed/README.md) |
 **[中文](https://github.com/sunbos/sqlseed/blob/main/plugins/mcp-server-sqlseed/README.zh-CN.md)**
 
-为 [sqlseed](https://sunbos.github.io/sqlseed/) 提供
+为 [sqlseed](https://sunbos.github.io/sqlseed/zh-CN/) 提供
 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 工具：从数据库结构推导
 YAML 配置，再生成测试数据。两个工具均使用离线 Core 规则，无需 LLM。
 
 ## 安装
 
-安装 0.2.4 版本时，使用 Python 3.10+ 虚拟环境：
+本文安装说明对应 0.2.6 版本；发布状态以 [Releases](https://github.com/sunbos/sqlseed/releases) 为准。测试尚未发布的候选版本时，使用下方的源码安装方式。请先创建并激活 Python 3.10+ 虚拟环境：
 
 ```bash
-python -m pip install "mcp-server-sqlseed==0.2.4"
+python -m pip install "mcp-server-sqlseed==0.2.6"
 ```
 
-Core 0.2.3 缺少当前入口使用的数据库目标校验接口。
+Core 0.2.4 及更早版本缺少本版本使用的共享诊断接口。
 开发源码时，从仓库根一次安装本地 Core 与 MCP：
 
 ```bash
@@ -48,12 +48,14 @@ python -m pip install -e . -e ./plugins/mcp-server-sqlseed
 
 `db_path` 接受已存在的 SQLite `.db`、`.sqlite`、`.sqlite3` 文件或数据库 URL。
 使用 PostgreSQL 时需在同一环境安装 Core 的 `postgres` extra。目标表必须已存在。
-列映射由 Core 规则确定，两个工具都不会向模型发送请求。
+列映射由 Core 规则确定，两个工具都不会向模型发送请求。两者均使用 Core 必需依赖
+Faker 和 `en_US` locale，与生成的模板一致；无需安装 Mimesis。
 
 提供 `yaml_config` 时，其内容必须为 YAML mapping，并包含所请求的表。
 空文档、未知目标表或不包含目标表的配置会在生成前失败；UTF-8 编码后上限为 256 KiB。
 工具参数决定数据库、表、生成行数和 enrich；YAML 仅提供匹配表的列规则、seed 与
-`clear_before`，不覆盖工具参数指定的范围。
+`clear_before`，不覆盖工具参数指定的范围。YAML 顶层的 `provider` 和 `locale`
+不会改变此服务器使用的引擎或语言地区。
 
 ## 使用示例与失败结果
 
@@ -77,7 +79,7 @@ MCP 传输成功不等于配置或填充成功，需要检查返回内容。
 LLM 分析属于另一个 AI MCP 进程，安装 AI extra 后启动：
 
 ```bash
-python -m pip install "sqlseed-ai[mcp]==0.2.4"
+python -m pip install "sqlseed-ai[mcp]==0.2.6"
 mcp-server-sqlseed-ai
 ```
 
@@ -89,12 +91,14 @@ AI YAML 工具名为 `sqlseed_ai_generate_yaml`，命令入口为 `mcp-server-sq
 
 ## 依赖
 
+以下为 0.2.6 版本及其源码候选的依赖要求。源码开发时请在同一次解析中安装本地 Core 和插件。
+
 - Python `>=3.10`
-- `sqlseed>=0.2.4.dev0,<0.3`
+- `sqlseed>=0.2.5.dev0,<0.3`
 - `mcp>=1.0,<2`
 
-更多信息见[用户指南](https://sunbos.github.io/sqlseed/guide/)、
-[升级说明](https://sunbos.github.io/sqlseed/migration.zh-CN/)和
+更多信息见[用户指南](https://sunbos.github.io/sqlseed/zh-CN/guide/)、
+[升级说明](https://sunbos.github.io/sqlseed/zh-CN/migration/)和
 [服务器源码](https://github.com/sunbos/sqlseed/tree/main/plugins/mcp-server-sqlseed)。
 
 许可证：[AGPL-3.0-or-later](https://github.com/sunbos/sqlseed/blob/main/LICENSE)。

{mcp_server_sqlseed-0.2.4 → mcp_server_sqlseed-0.2.6}/pyproject.toml

@@ -23,7 +23,7 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-    "sqlseed>=0.2.4.dev0,<0.3",
+    "sqlseed>=0.2.5.dev0,<0.3",
     "mcp>=1.0,<2",
 ]
 

{mcp_server_sqlseed-0.2.4 → mcp_server_sqlseed-0.2.6}/src/mcp_server_sqlseed/server.py

@@ -19,8 +19,10 @@ from sqlseed._utils.logger import get_logger
 from sqlseed._utils.paths import validate_db_target as _validate_db_target
 from sqlseed._utils.paths import validate_table_name as _validate_table_name
 from sqlseed._utils.progress import NullProgressBackend
+from sqlseed._utils.redaction import redact_url_credentials
 from sqlseed.config.models import GeneratorConfig
 from sqlseed.core.orchestrator import DataOrchestrator
+from sqlseed.generators import ConfigurationError
 
 logger = get_logger(__name__)
 
@@ -56,7 +58,7 @@ def sqlseed_generate_yaml(db_path: str, table_name: str) -> str:
     """
     try:
         db_path = _validate_db_target(db_path)
-        with DataOrchestrator(db_path) as orch:
+        with DataOrchestrator(db_path, provider_name="faker", locale="en_US") as orch:
             _validate_table_name(table_name, orch.get_table_names())
             specs = orch.get_column_mapping(table_name)
 
@@ -69,9 +71,15 @@ def sqlseed_generate_yaml(db_path: str, table_name: str) -> str:
         }
         logger.info("Rule-driven YAML generated", table_name=table_name, columns=len(columns))
         return str(yaml.dump(output, allow_unicode=True, sort_keys=False, default_flow_style=False))
-    except (ValueError, RuntimeError, OSError) as e:
-        logger.error("Failed to generate YAML", db_path=db_path, table_name=table_name, error=str(e))
-        return f"# Error: {e}"
+    except (ValueError, RuntimeError, OSError, ConfigurationError) as e:
+        message = redact_url_credentials(str(e))
+        logger.error(
+            "Failed to generate YAML",
+            db_path=redact_url_credentials(db_path),
+            table_name=table_name,
+            error=message,
+        )
+        return f"# Error: {message}"
 
 
 @mcp.tool()
@@ -89,7 +97,7 @@ def sqlseed_execute_fill(
         if yaml_config is not None and len(yaml_config.encode("utf-8")) > _MAX_YAML_CONFIG_SIZE:
             raise ValueError(f"yaml_config exceeds maximum allowed size of {_MAX_YAML_CONFIG_SIZE} bytes")
 
-        with DataOrchestrator(db_path) as orch:
+        with DataOrchestrator(db_path, provider_name="faker", locale="en_US") as orch:
             _validate_table_name(table_name, orch.get_table_names())
             column_configs = None
             clear_before = False
@@ -133,8 +141,14 @@ def sqlseed_execute_fill(
                 "table_name": result.table_name,
                 "count": result.count,
                 "elapsed": result.elapsed,
-                "errors": result.errors,
+                "errors": [redact_url_credentials(error) for error in result.errors],
             }
-    except (ValueError, RuntimeError, OSError, yaml.YAMLError) as e:
-        logger.error("Failed to execute fill", db_path=db_path, table_name=table_name, error=str(e))
-        return {"error": str(e)}
+    except (ValueError, RuntimeError, OSError, ConfigurationError, yaml.YAMLError) as e:
+        message = redact_url_credentials(str(e))
+        logger.error(
+            "Failed to execute fill",
+            db_path=redact_url_credentials(db_path),
+            table_name=table_name,
+            error=message,
+        )
+        return {"error": message}

mcp_server_sqlseed-0.2.6/tests/test_default_provider.py

@@ -0,0 +1,114 @@
+from __future__ import annotations
+
+import json
+import subprocess
+import sys
+import textwrap
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+
+def test_mcp_uses_faker_en_us_without_mimesis(tmp_path: Path) -> None:
+    """Compare real SQLite values with upstream Faker, including default mapping."""
+    program = textwrap.dedent(
+        """
+        import importlib.abc
+        import json
+        import sys
+
+        class MissingMimesis(importlib.abc.MetaPathFinder):
+            def find_spec(self, fullname, path=None, target=None):
+                if fullname == 'mimesis' or fullname.startswith('mimesis.'):
+                    raise ModuleNotFoundError('Unavailable test dependency: ' + fullname)
+        sys.meta_path.insert(0, MissingMimesis())
+
+        from faker import Faker
+        from structlog.testing import capture_logs
+        import yaml
+
+        with capture_logs() as events:
+            from mcp_server_sqlseed.server import sqlseed_execute_fill, sqlseed_generate_yaml
+            from sqlseed.core.orchestrator import DataOrchestrator
+            from sqlseed.generators import registry
+            from tests.sqlite_helpers import sqlite_connection
+
+            database = sys.argv[1]
+            seed = 31415
+            count = 5
+            with sqlite_connection(database) as connection:
+                connection.execute('CREATE TABLE people (first_name TEXT NOT NULL)')
+
+            template = yaml.safe_load(sqlseed_generate_yaml(database, 'people'))
+            template_defaults = {key: template[key] for key in ('provider', 'locale')}
+            expected_faker = Faker('en_US')
+            expected_faker.seed_instance(seed)
+            expected = [expected_faker.first_name() for _ in range(count)]
+
+            def read_names():
+                with sqlite_connection(database) as connection:
+                    return [row[0] for row in connection.execute(
+                        'SELECT first_name FROM people ORDER BY rowid'
+                    )]
+
+            # No YAML: use the upstream seed API, without replacing the provider.
+            Faker.seed(seed)
+            default_result = sqlseed_execute_fill(database, 'people', count=count)
+            default_names = read_names()
+
+            table = template['tables'][0]
+            table['seed'] = seed
+            table['clear_before'] = True
+            generated_result = sqlseed_execute_fill(
+                database, 'people', count=count, yaml_config=yaml.safe_dump(template)
+            )
+            generated_names = read_names()
+
+            # Top-level engine/locale settings remain outside the tool's YAML scope.
+            template['provider'] = 'mimesis'
+            template['locale'] = 'zh_CN'
+            overridden_result = sqlseed_execute_fill(
+                database, 'people', count=count, yaml_config=yaml.safe_dump(template)
+            )
+            overridden_names = read_names()
+            tool_warnings = [event for event in events if event['log_level'] == 'warning']
+
+            # Positive control: the explicit unavailable Core provider still warns.
+            events.clear()
+            with DataOrchestrator(database, provider_name='mimesis') as orchestrator:
+                tables = orchestrator.get_table_names()
+            fallback_warnings = [event for event in events if event['log_level'] == 'warning']
+
+        print(json.dumps({
+            'mimesis_available': registry.HAS_MIMESIS,
+            'template_defaults': template_defaults,
+            'expected': expected,
+            'names': [default_names, generated_names, overridden_names],
+            'results': [default_result, generated_result, overridden_result],
+            'tool_warnings': tool_warnings,
+            'fallback_warnings': fallback_warnings,
+            'tables': tables,
+        }))
+        """
+    )
+    result = subprocess.run(
+        [sys.executable, "-c", program, str(tmp_path / "faker-default.db")],
+        capture_output=True,
+        text=True,
+        check=True,
+        timeout=60,
+    )
+    status = json.loads(result.stdout)
+    assert status["mimesis_available"] is False
+    assert status["template_defaults"] == {"provider": "faker", "locale": "en_US"}
+    assert status["names"] == [status["expected"]] * 3
+    for fill_result in status["results"]:
+        assert fill_result["count"] == 5
+        assert fill_result["errors"] == []
+    assert status["tool_warnings"] == []
+    assert status["tables"] == ["people"]
+    assert any(
+        event["event"] == "Provider not available, falling back to 'base'" and event["provider_name"] == "mimesis"
+        for event in status["fallback_warnings"]
+    )

mcp_server_sqlseed-0.2.6/tests/test_error_redaction.py

@@ -0,0 +1,24 @@
+"""Both core MCP error shapes and their stderr diagnostics hide URL credentials."""
+
+from __future__ import annotations
+
+import subprocess
+import sys
+
+
+def test_core_mcp_malformed_url_is_redacted_in_results_and_logs() -> None:
+    script = """
+from mcp_server_sqlseed.server import sqlseed_generate_yaml, sqlseed_execute_fill
+target='sqlite://audit-user:synthetic-userinfo@host/db?password=synthetic-query'
+for fn in (sqlseed_generate_yaml, sqlseed_execute_fill):
+    result=fn(target, 'items')
+    message=result if isinstance(result,str) else result['error']
+    assert 'Invalid database URL' in message
+    assert 'synthetic-userinfo' not in message and 'synthetic-query' not in message
+    print(message)
+"""
+    result = subprocess.run([sys.executable, "-c", script], capture_output=True, text=True, timeout=30, check=True)
+    assert "Failed to generate YAML" in result.stderr
+    assert "Failed to execute fill" in result.stderr
+    assert "synthetic-userinfo" not in result.stdout + result.stderr
+    assert "synthetic-query" not in result.stdout + result.stderr

{mcp_server_sqlseed-0.2.4 → mcp_server_sqlseed-0.2.6}/tests/test_yaml_execution_validation.py

@@ -97,3 +97,35 @@ def test_valid_yaml_keeps_tool_target_count_and_matching_column_rules(tmp_path:
     with closing(sqlite3.connect(database)) as connection:
         assert connection.execute("SELECT value FROM users ORDER BY rowid").fetchall() == [(91,), (17,), (17,)]
         assert connection.execute("SELECT value FROM orders").fetchall() == [(92,)]
+
+
+def test_invalid_date_range_returns_tool_error_without_appending(tmp_path: Path) -> None:
+    database = tmp_path / "invalid-date.db"
+    with closing(sqlite3.connect(database)) as connection:
+        connection.executescript(
+            "CREATE TABLE events (created_at DATE NOT NULL); INSERT INTO events VALUES ('2020-01-01');"
+        )
+    document = yaml.safe_dump(
+        {
+            "db_path": str(database),
+            "tables": [
+                {
+                    "name": "events",
+                    "count": 5,
+                    "columns": [
+                        {
+                            "name": "created_at",
+                            "generator": "date",
+                            "params": {"start_date": "2026-09-26", "end_date": "2026-09-26", "weekdays": "workdays"},
+                        }
+                    ],
+                }
+            ],
+        }
+    )
+    result = sqlseed_execute_fill(str(database), "events", count=5, yaml_config=document)
+    assert set(result) == {"error"}
+    assert "created_at" in result["error"]
+    assert "date" in result["error"]
+    with closing(sqlite3.connect(database)) as connection:
+        assert connection.execute("SELECT * FROM events").fetchall() == [("2020-01-01",)]