db-connect-mcp 0.1.0__tar.gz → 0.1.3__tar.gz

{db_connect_mcp-0.1.0 → db_connect_mcp-0.1.3}/PKG-INFO

@@ -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 → db_connect_mcp-0.1.3}/README.md

@@ -28,8 +28,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"
          }
@@ -73,7 +72,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+)
@@ -241,14 +240,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
@@ -270,14 +268,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"
       }
@@ -286,14 +284,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"
       }
@@ -307,15 +305,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"
       }
@@ -441,35 +437,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 → db_connect_mcp-0.1.3}/pyproject.toml

@@ -4,14 +4,12 @@ build-backend = "hatchling.build"
 
 [project]
 name = "db-connect-mcp"
-version = "0.1.0"
+version = "0.1.3"
 description = "Multi-database MCP server for PostgreSQL, MySQL, and ClickHouse"
 readme = "README.md"
-requires-python = ">=3.13"
-license = {text = "MIT"}
-authors = [
-    {name = "Yuri Gui", email = "yugui923@users.noreply.github.com"}
-]
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Yuri Gui", email = "yugui923@users.noreply.github.com" }]
 keywords = [
     "mcp",
     "database",
@@ -20,13 +18,16 @@ keywords = [
     "clickhouse",
     "claude",
     "analysis",
-    "data-exploration"
+    "data-exploration",
 ]
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Topic :: Database",
     "Topic :: Software Development :: Libraries :: Python Modules",
@@ -67,8 +68,7 @@ dev = [
 only-include = ["src/db_connect_mcp"]
 
 [tool.hatch.build.targets.wheel]
-only-include = ["src/db_connect_mcp"]
-sources = ["src"]
+packages = ["src/db_connect_mcp"]
 
 [tool.pytest.ini_options]
 asyncio_mode = "auto"

{db_connect_mcp-0.1.0 → db_connect_mcp-0.1.3}/src/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],