db-connect-mcp 0.1.2__tar.gz → 0.1.4__tar.gz

{db_connect_mcp-0.1.2 → db_connect_mcp-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: db-connect-mcp
-Version: 0.1.2
+Version: 0.1.4
 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.2 → db_connect_mcp-0.1.4}/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.2 → db_connect_mcp-0.1.4}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "hatchling.build"
 
 [project]
 name = "db-connect-mcp"
-version = "0.1.2"
+version = "0.1.4"
 description = "Multi-database MCP server for PostgreSQL, MySQL, and ClickHouse"
 readme = "README.md"
-requires-python = ">=3.13"
+requires-python = ">=3.10"
 license = { text = "MIT" }
 authors = [{ name = "Yuri Gui", email = "yugui923@users.noreply.github.com" }]
 keywords = [
@@ -25,6 +25,9 @@ classifiers = [
     "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",
@@ -47,7 +50,7 @@ Repository = "https://github.com/yugui923/db-connect-mcp"
 Issues = "https://github.com/yugui923/db-connect-mcp/issues"
 
 [project.scripts]
-db-connect-mcp = "db_connect_mcp.server:main"
+db-connect-mcp = "db_connect_mcp.server:cli_entry"
 
 [dependency-groups]
 dev = [

db_connect_mcp-0.1.4/src/db_connect_mcp/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for running db_connect_mcp as a module."""
+
+from db_connect_mcp.server import cli_entry
+
+if __name__ == "__main__":
+    cli_entry()

{db_connect_mcp-0.1.2 → db_connect_mcp-0.1.4}/src/db_connect_mcp/server.py

@@ -488,9 +488,25 @@ async def main() -> None:
         await mcp_server.cleanup()
 
 
-if __name__ == "__main__":
+def cli_entry() -> None:
+    """
+    Synchronous entry point for console script.
+
+    This function is called by the 'db-connect-mcp' console script.
+    It sets up the event loop and runs the async main() function.
+    """
     # Windows-specific event loop policy
     if os.name == "nt":
         asyncio.set_event_loop_policy(asyncio.WindowsProactorEventLoopPolicy())  # type: ignore[attr-defined]
 
-    asyncio.run(main())
+    try:
+        asyncio.run(main())
+    except KeyboardInterrupt:
+        logger.info("Server stopped by user")
+    except Exception as e:
+        logger.error(f"Server error: {e}", exc_info=True)
+        raise
+
+
+if __name__ == "__main__":
+    cli_entry()

db_connect_mcp-0.1.2/src/db_connect_mcp/__main__.py

@@ -1,13 +0,0 @@
-"""Entry point for running db_connect_mcp as a module."""
-
-import asyncio
-import sys
-
-from db_connect_mcp.server import main
-
-if __name__ == "__main__":
-    # Windows-specific event loop policy
-    if sys.platform == "win32":
-        asyncio.set_event_loop_policy(asyncio.WindowsProactorEventLoopPolicy())  # type: ignore[attr-defined]
-
-    asyncio.run(main())