db-connect-mcp 0.1.2__py3-none-any.whl → 0.1.4__py3-none-any.whl

db_connect_mcp/__main__.py

@@ -1,13 +1,6 @@
 """Entry point for running db_connect_mcp as a module."""
 
-import asyncio
-import sys
-
-from db_connect_mcp.server import main
+from db_connect_mcp.server import cli_entry
 
 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())
+    cli_entry()

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.dist-info → db_connect_mcp-0.1.4.dist-info}/METADATA

@@ -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.dist-info → db_connect_mcp-0.1.4.dist-info}/RECORD

@@ -1,6 +1,6 @@
 db_connect_mcp/__init__.py,sha256=HBy0IhP1gAQEGVscnMsyBtjLGLGx2Utd4SwOMMQijBw,816
-db_connect_mcp/__main__.py,sha256=uUbJtogwzOjQatBlmM6Vf0FLYBrtlN1LB25M0DIp25M,361
-db_connect_mcp/server.py,sha256=-k7594K5UeAeIUpuzU5uwLPO793lT8R0L1zwlotbfnQ,17350
+db_connect_mcp/__main__.py,sha256=x-ziUf30cHyn-feL61FJCP_TYJfTQIFRSjlAn3D7_VM,147
+db_connect_mcp/server.py,sha256=SN8fCJ1G8dLTjWbuHkFn0op2BeM2cCW1QoZw4f7f-vc,17780
 db_connect_mcp/adapters/__init__.py,sha256=f89QV2q4-7iqRyqQEMz7gQ4DbEJcVSzreYF1gUQdf5c,1743
 db_connect_mcp/adapters/base.py,sha256=23dIGmdnPZmGnc-PjJgXLrMUru3MWqTI3-alSyA31A4,4124
 db_connect_mcp/adapters/clickhouse.py,sha256=BvSbIJGZZtIIrd6FziVxA6Y-vshqb3Xc_WLuehGdKU0,10619
@@ -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.2.dist-info/METADATA,sha256=pSDE1HrJmdkm_MuSHN7z--PFV_iTZniUQggHNTednAE,18111
-db_connect_mcp-0.1.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-db_connect_mcp-0.1.2.dist-info/entry_points.txt,sha256=UoN-St_MnE5kk4ZDEvzMi6dCvNi0CmvsqbPpYNxJOac,62
-db_connect_mcp-0.1.2.dist-info/licenses/LICENSE,sha256=c71UYlLh5ubuIlgVlM3EMkFdhWxTIULtUx_a8KOhI8w,1065
-db_connect_mcp-0.1.2.dist-info/RECORD,,
+db_connect_mcp-0.1.4.dist-info/METADATA,sha256=son3d_gmNkbxQkG4RERvQGwBBAf_q5FNcywFQ5NQWEA,18351
+db_connect_mcp-0.1.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+db_connect_mcp-0.1.4.dist-info/entry_points.txt,sha256=KjyjOdBJEFQutb9nB9Zvjc9XdjQ81O6H88r-Nb9vKGY,67
+db_connect_mcp-0.1.4.dist-info/licenses/LICENSE,sha256=c71UYlLh5ubuIlgVlM3EMkFdhWxTIULtUx_a8KOhI8w,1065
+db_connect_mcp-0.1.4.dist-info/RECORD,,

db_connect_mcp-0.1.4.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+db-connect-mcp = db_connect_mcp.server:cli_entry

db_connect_mcp-0.1.2.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-db-connect-mcp = db_connect_mcp.server:main