db-connect-mcp 0.1.0__py3-none-any.whl → 0.1.3__py3-none-any.whl

db_connect_mcp/adapters/base.py

@@ -1,7 +1,7 @@
 """Base adapter abstract class for database-specific implementations."""
 
 from abc import ABC, abstractmethod
-from typing import Any, Optional
+from typing import Any, Optional, Union, TYPE_CHECKING
 
 from sqlalchemy.ext.asyncio import AsyncConnection
 
@@ -10,6 +10,12 @@ from db_connect_mcp.models.database import SchemaInfo
 from db_connect_mcp.models.statistics import ColumnStats, Distribution
 from db_connect_mcp.models.table import TableInfo
 
+if TYPE_CHECKING:
+    from db_connect_mcp.core.connection import AsyncConnectionWrapper
+
+# Type alias for connection types
+ConnectionType = Union[AsyncConnection, "AsyncConnectionWrapper"]
+
 
 class BaseAdapter(ABC):
     """Base adapter defining database-specific interface."""
@@ -22,7 +28,7 @@ class BaseAdapter(ABC):
 
     @abstractmethod
     async def enrich_schema_info(
-        self, conn: AsyncConnection, schema_info: SchemaInfo
+        self, conn: ConnectionType, schema_info: SchemaInfo
     ) -> SchemaInfo:
         """
         Enrich schema info with database-specific metadata.
@@ -38,7 +44,7 @@ class BaseAdapter(ABC):
 
     @abstractmethod
     async def enrich_table_info(
-        self, conn: AsyncConnection, table_info: TableInfo
+        self, conn: ConnectionType, table_info: TableInfo
     ) -> TableInfo:
         """
         Enrich table info with database-specific metadata.
@@ -55,7 +61,7 @@ class BaseAdapter(ABC):
     @abstractmethod
     async def get_column_statistics(
         self,
-        conn: AsyncConnection,
+        conn: ConnectionType,
         table_name: str,
         column_name: str,
         schema: Optional[str],
@@ -77,7 +83,7 @@ class BaseAdapter(ABC):
     @abstractmethod
     async def get_value_distribution(
         self,
-        conn: AsyncConnection,
+        conn: ConnectionType,
         table_name: str,
         column_name: str,
         schema: Optional[str],

{db_connect_mcp-0.1.0.dist-info → db_connect_mcp-0.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: db-connect-mcp
-Version: 0.1.0
+Version: 0.1.3
 Summary: Multi-database MCP server for PostgreSQL, MySQL, and ClickHouse
 Project-URL: Homepage, https://github.com/yugui923/db-connect-mcp
 Project-URL: Repository, https://github.com/yugui923/db-connect-mcp
@@ -14,10 +14,13 @@ Classifier: Framework :: AsyncIO
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Database
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.13
+Requires-Python: >=3.10
 Requires-Dist: aiomysql>=0.2.0
 Requires-Dist: asyncpg>=0.29.0
 Requires-Dist: clickhouse-connect>=0.7.0
@@ -57,8 +60,7 @@ A read-only MCP (Model Context Protocol) server for exploratory data analysis ac
    {
      "mcpServers": {
        "db-connect": {
-         "command": "uv",
-         "args": ["run", "python", "C:/path/to/db-connect-mcp/main.py"],
+         "command": "db-connect-mcp",
          "env": {
            "DATABASE_URL": "postgresql://user:pass@localhost:5432/mydb"
          }
@@ -102,7 +104,7 @@ A read-only MCP (Model Context Protocol) server for exploratory data analysis ac
 ## Installation
 
 ### Prerequisites
-- Python 3.13 or higher
+- Python 3.10 or higher
 - One or more of:
   - PostgreSQL database (9.6+)
   - MySQL/MariaDB database (5.7+/10.2+)
@@ -270,14 +272,13 @@ If installed from PyPI:
 db-connect-mcp
 ```
 
-If running from source:
+If running from source (development):
 ```bash
-python main.py
-```
+# Using module approach (recommended)
+python -m db_connect_mcp
 
-Or with uv:
-```bash
-uv run python main.py
+# Or using uv
+uv run db-connect-mcp
 ```
 
 ### Using with Claude Desktop
@@ -299,14 +300,14 @@ Add the server to your Claude Desktop configuration (`claude_desktop_config.json
 }
 ```
 
-#### If installed from source:
+#### If running from source (development):
 
 ```json
 {
   "mcpServers": {
     "db-connect": {
       "command": "python",
-      "args": ["C:/path/to/db-connect-mcp/main.py"],
+      "args": ["-m", "db_connect_mcp"],
       "env": {
         "DATABASE_URL": "postgresql+asyncpg://user:pass@host:5432/db"
       }
@@ -315,14 +316,14 @@ Add the server to your Claude Desktop configuration (`claude_desktop_config.json
 }
 ```
 
-#### Or using uv (for source installation):
+#### Or using uv (for development with dependencies):
 
 ```json
 {
   "mcpServers": {
     "db-connect": {
       "command": "uv",
-      "args": ["run", "python", "C:/path/to/db-connect-mcp/main.py"],
+      "args": ["--directory", "C:/path/to/db-connect-mcp", "run", "db-connect-mcp"],
       "env": {
         "DATABASE_URL": "mysql+aiomysql://user:pass@host:3306/db"
       }
@@ -336,15 +337,13 @@ You can configure multiple database connections:
 {
   "mcpServers": {
     "postgres-prod": {
-      "command": "uv",
-      "args": ["run", "python", "C:/path/to/db-connect-mcp/main.py"],
+      "command": "db-connect-mcp",
       "env": {
         "DATABASE_URL": "postgresql+asyncpg://user:pass@pg-host:5432/db"
       }
     },
     "mysql-analytics": {
-      "command": "uv",
-      "args": ["run", "python", "C:/path/to/db-connect-mcp/main.py"],
+      "command": "db-connect-mcp",
       "env": {
         "DATABASE_URL": "mysql+aiomysql://user:pass@mysql-host:3306/analytics"
       }
@@ -470,35 +469,36 @@ Once configured, you can use the server in Claude:
 ```
 db-connect-mcp/
 ├── src/
-│   ├── adapters/         # Database-specific adapters
-│   │   ├── __init__.py
-│   │   ├── base.py      # Base adapter interface
-│   │   ├── postgresql.py # PostgreSQL adapter
-│   │   ├── mysql.py     # MySQL adapter
-│   │   └── clickhouse.py # ClickHouse adapter
-│   ├── core/            # Core functionality
-│   │   ├── __init__.py
-│   │   ├── connection.py # Database connection management
-│   │   ├── executor.py  # Query execution
-│   │   ├── inspector.py # Metadata inspection
-│   │   └── analyzer.py  # Statistical analysis
-│   ├── models/          # Data models
-│   │   ├── __init__.py
-│   │   ├── capabilities.py # Database capabilities
-│   │   ├── config.py    # Configuration models
-│   │   ├── database.py  # Database models
-│   │   ├── query.py     # Query models
-│   │   ├── statistics.py # Statistics models
-│   │   └── table.py     # Table metadata models
-│   ├── __init__.py
-│   ├── __main__.py
-│   └── server.py        # Main MCP server implementation
+│   └── db_connect_mcp/
+│       ├── adapters/         # Database-specific adapters
+│       │   ├── __init__.py
+│       │   ├── base.py      # Base adapter interface
+│       │   ├── postgresql.py # PostgreSQL adapter
+│       │   ├── mysql.py     # MySQL adapter
+│       │   └── clickhouse.py # ClickHouse adapter
+│       ├── core/            # Core functionality
+│       │   ├── __init__.py
+│       │   ├── connection.py # Database connection management
+│       │   ├── executor.py  # Query execution
+│       │   ├── inspector.py # Metadata inspection
+│       │   └── analyzer.py  # Statistical analysis
+│       ├── models/          # Data models
+│       │   ├── __init__.py
+│       │   ├── capabilities.py # Database capabilities
+│       │   ├── config.py    # Configuration models
+│       │   ├── database.py  # Database models
+│       │   ├── query.py     # Query models
+│       │   ├── statistics.py # Statistics models
+│       │   └── table.py     # Table metadata models
+│       ├── __init__.py
+│       ├── __main__.py      # Module entry point
+│       └── server.py        # Main MCP server implementation
 ├── tests/
 │   ├── conftest.py      # Test configuration
 │   └── test_server.py   # Integration tests
 ├── .env.example         # Example environment configuration
-├── main.py             # Entry point
-├── pyproject.toml      # Project dependencies
+├── main.py             # Legacy entry point (optional)
+├── pyproject.toml      # Project dependencies and console scripts
 └── README.md          # This file
 ```
 

{db_connect_mcp-0.1.0.dist-info → db_connect_mcp-0.1.3.dist-info}/RECORD

@@ -2,7 +2,7 @@ db_connect_mcp/__init__.py,sha256=HBy0IhP1gAQEGVscnMsyBtjLGLGx2Utd4SwOMMQijBw,81
 db_connect_mcp/__main__.py,sha256=uUbJtogwzOjQatBlmM6Vf0FLYBrtlN1LB25M0DIp25M,361
 db_connect_mcp/server.py,sha256=-k7594K5UeAeIUpuzU5uwLPO793lT8R0L1zwlotbfnQ,17350
 db_connect_mcp/adapters/__init__.py,sha256=f89QV2q4-7iqRyqQEMz7gQ4DbEJcVSzreYF1gUQdf5c,1743
-db_connect_mcp/adapters/base.py,sha256=HVeS-1Pd22ZOGtrA4u2yQT7d6H4zmWTI14bOOjbvBcU,3916
+db_connect_mcp/adapters/base.py,sha256=23dIGmdnPZmGnc-PjJgXLrMUru3MWqTI3-alSyA31A4,4124
 db_connect_mcp/adapters/clickhouse.py,sha256=BvSbIJGZZtIIrd6FziVxA6Y-vshqb3Xc_WLuehGdKU0,10619
 db_connect_mcp/adapters/mysql.py,sha256=U-kQ80JiYno5KKXfWgDiXoArine_JqpjHXKHoMq9R_Q,9914
 db_connect_mcp/adapters/postgresql.py,sha256=cLl8AhAc1hquUg-oduhYut9omE_zEkEjBQZBYqpkPl0,12592
@@ -18,8 +18,8 @@ db_connect_mcp/models/database.py,sha256=MEg5pimkkvMhdre7u2oVWRyuaJToja26Rjro-QC
 db_connect_mcp/models/query.py,sha256=FazyV6pWEJFUDlYPswOmCGJTUgT14f9xfzQHZhxh9n0,4398
 db_connect_mcp/models/statistics.py,sha256=ii_UqybC9L5P1DF4KN0XOnG49s4cmYlOdWDAdkVhqUc,6208
 db_connect_mcp/models/table.py,sha256=v1HhItb2UqS9QpAfMgDoDyU_6xDgvy4r3BlEE7QliSs,8445
-db_connect_mcp-0.1.0.dist-info/METADATA,sha256=QqaoYT-xLEdVBeINqV1wxk0SC_fmZi7FAczZq_Bv6-8,18111
-db_connect_mcp-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-db_connect_mcp-0.1.0.dist-info/entry_points.txt,sha256=UoN-St_MnE5kk4ZDEvzMi6dCvNi0CmvsqbPpYNxJOac,62
-db_connect_mcp-0.1.0.dist-info/licenses/LICENSE,sha256=c71UYlLh5ubuIlgVlM3EMkFdhWxTIULtUx_a8KOhI8w,1065
-db_connect_mcp-0.1.0.dist-info/RECORD,,
+db_connect_mcp-0.1.3.dist-info/METADATA,sha256=0x7lLaw15abY6HfwQglaDBsmGj2KlEZoL0NbFh4ZUDY,18351
+db_connect_mcp-0.1.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+db_connect_mcp-0.1.3.dist-info/entry_points.txt,sha256=UoN-St_MnE5kk4ZDEvzMi6dCvNi0CmvsqbPpYNxJOac,62
+db_connect_mcp-0.1.3.dist-info/licenses/LICENSE,sha256=c71UYlLh5ubuIlgVlM3EMkFdhWxTIULtUx_a8KOhI8w,1065
+db_connect_mcp-0.1.3.dist-info/RECORD,,