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

{db_connect_mcp-0.1.4.dist-info → db_connect_mcp-0.1.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: db-connect-mcp
-Version: 0.1.4
+Version: 0.1.5
 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
@@ -38,29 +38,16 @@ A read-only MCP (Model Context Protocol) server for exploratory data analysis ac
 
 1. **Install:**
    ```bash
-   # Option 1: From PyPI (recommended)
    pip install db-connect-mcp
-
-   # Option 2: From source
-   git clone https://github.com/yugui923/db-connect-mcp.git
-   cd db-connect-mcp
-   uv sync
-   ```
-
-2. **Configure** `.env`:
-   ```env
-   DATABASE_URL=postgres://user:pass@localhost:5432/mydb
-   # Also supports: postgresql://, pg://, jdbc:postgresql://
-   # MariaDB: mariadb://, jdbc:mysql://, jdbc:mariadb://
-   # ClickHouse: ch://, jdbc:clickhouse://
    ```
 
-3. **Add to Claude Desktop** `claude_desktop_config.json`:
+2. **Add to Claude Desktop** `claude_desktop_config.json`:
    ```json
    {
      "mcpServers": {
        "db-connect": {
-         "command": "db-connect-mcp",
+         "command": "python",
+         "args": ["-m", "db_connect_mcp"],
          "env": {
            "DATABASE_URL": "postgresql://user:pass@localhost:5432/mydb"
          }
@@ -69,7 +56,9 @@ A read-only MCP (Model Context Protocol) server for exploratory data analysis ac
    }
    ```
 
-4. **Restart Claude Desktop** and start querying your database!
+3. **Restart Claude Desktop** and start querying your database!
+
+> **Note**: Using `python -m db_connect_mcp` ensures the command works even if Python's Scripts directory isn't in your PATH.
 
 ## Features
 
@@ -104,48 +93,18 @@ A read-only MCP (Model Context Protocol) server for exploratory data analysis ac
 ## Installation
 
 ### Prerequisites
-- Python 3.10 or higher
-- One or more of:
-  - PostgreSQL database (9.6+)
-  - MySQL/MariaDB database (5.7+/10.2+)
-  - ClickHouse database
+- **Python 3.10 or higher**
+- **A database**: PostgreSQL (9.6+), MySQL/MariaDB (5.7+/10.2+), or ClickHouse
 
-### Method 1: Install from PyPI (Recommended)
+### Install via pip
 
 ```bash
 pip install db-connect-mcp
 ```
 
-### Method 2: Install from Source
-
-For development or the latest features:
-
-```bash
-# Clone the repository
-git clone https://github.com/yugui923/db-connect-mcp.git
-cd db-connect-mcp
-
-# Install with uv (recommended)
-uv sync
-
-# Or install with pip
-pip install -e .
-```
-
-### Method 3: Install from GitHub
-
-```bash
-pip install git+https://github.com/yugui923/db-connect-mcp.git
-```
-
-### Configuration
-
-After installation, configure your database connection:
+That's it! The package is now ready to use.
 
-```bash
-cp .env.example .env
-# Edit .env with your database connection string
-```
+> **For developers**: See [Development Guide](docs/DEVELOPMENT.md) for setting up a development environment.
 
 ## Configuration
 
@@ -267,41 +226,20 @@ DATABASE_URL=ch://user:pass@host:9000/db?timeout=60&max_threads=4
 
 ### Running the Server
 
-If installed from PyPI:
-```bash
-db-connect-mcp
-```
-
-If running from source (development):
 ```bash
-# Using module approach (recommended)
+# Run the server (works everywhere, no PATH configuration needed)
 python -m db_connect_mcp
 
-# Or using uv
-uv run db-connect-mcp
+# With environment variable
+DATABASE_URL="postgresql://user:pass@host:5432/db" python -m db_connect_mcp
 ```
 
+> **Note**: Using `python -m db_connect_mcp` works regardless of whether Python's Scripts directory is in your PATH.
+
 ### Using with Claude Desktop
 
 Add the server to your Claude Desktop configuration (`claude_desktop_config.json`):
 
-#### If installed from PyPI:
-
-```json
-{
-  "mcpServers": {
-    "db-connect": {
-      "command": "db-connect-mcp",
-      "env": {
-        "DATABASE_URL": "postgresql+asyncpg://user:pass@host:5432/db"
-      }
-    }
-  }
-}
-```
-
-#### If running from source (development):
-
 ```json
 {
   "mcpServers": {
@@ -316,34 +254,21 @@ Add the server to your Claude Desktop configuration (`claude_desktop_config.json
 }
 ```
 
-#### Or using uv (for development with dependencies):
+**Multiple database connections:**
 
-```json
-{
-  "mcpServers": {
-    "db-connect": {
-      "command": "uv",
-      "args": ["--directory", "C:/path/to/db-connect-mcp", "run", "db-connect-mcp"],
-      "env": {
-        "DATABASE_URL": "mysql+aiomysql://user:pass@host:3306/db"
-      }
-    }
-  }
-}
-```
-
-You can configure multiple database connections:
 ```json
 {
   "mcpServers": {
     "postgres-prod": {
-      "command": "db-connect-mcp",
+      "command": "python",
+      "args": ["-m", "db_connect_mcp"],
       "env": {
         "DATABASE_URL": "postgresql+asyncpg://user:pass@pg-host:5432/db"
       }
     },
     "mysql-analytics": {
-      "command": "db-connect-mcp",
+      "command": "python",
+      "args": ["-m", "db_connect_mcp"],
       "env": {
         "DATABASE_URL": "mysql+aiomysql://user:pass@mysql-host:3306/analytics"
       }
@@ -352,6 +277,8 @@ You can configure multiple database connections:
 }
 ```
 
+> **For development**: See [Development Guide](docs/DEVELOPMENT.md) for running from source with uv.
+
 ## Database Feature Support
 
 | Feature | PostgreSQL | MySQL | ClickHouse |
@@ -465,6 +392,8 @@ Once configured, you can use the server in Claude:
 
 ## Development
 
+For detailed development setup, testing, and contribution guidelines, see the [Development Guide](docs/DEVELOPMENT.md).
+
 ### Project Structure
 ```
 db-connect-mcp/
@@ -512,13 +441,8 @@ The server uses an adapter pattern to support multiple database systems:
 - **Server**: MCP server implementation that routes requests to appropriate components
 
 ### Running Tests
-```bash
-# Run integration tests
-uv run python tests/test_server.py
 
-# Or with pytest (when available)
-uv run pytest tests/
-```
+See the [Development Guide](docs/DEVELOPMENT.md#running-tests) and [Test Guide](tests/README.md) for detailed testing instructions.
 
 ## Troubleshooting
 

{db_connect_mcp-0.1.4.dist-info → db_connect_mcp-0.1.5.dist-info}/RECORD

@@ -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.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.5.dist-info/METADATA,sha256=_zN7lVDADM5Ho6G1bDK4n0F2_qheVaocTfsBYGQUgzg,17474
+db_connect_mcp-0.1.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+db_connect_mcp-0.1.5.dist-info/entry_points.txt,sha256=KjyjOdBJEFQutb9nB9Zvjc9XdjQ81O6H88r-Nb9vKGY,67
+db_connect_mcp-0.1.5.dist-info/licenses/LICENSE,sha256=c71UYlLh5ubuIlgVlM3EMkFdhWxTIULtUx_a8KOhI8w,1065
+db_connect_mcp-0.1.5.dist-info/RECORD,,