PyPI - iflow-mcp_mcp-db-navigator - Versions diffs - 1.0.2__tar.gz - Mend

iflow-mcp_mcp-db-navigator 1.0.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (17) hide show

iflow_mcp_mcp_db_navigator-1.0.2/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2024
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

iflow_mcp_mcp_db_navigator-1.0.2/PKG-INFO ADDED Viewed

@@ -0,0 +1,189 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_mcp-db-navigator
+Version: 1.0.2
+Summary: A powerful MySQL/MariaDB database navigation tool using MCP (Model Control Protocol).
+Author-email: "Ahmed S. Said-ahmed" <ahmed@pharoslab.net>
+License: MIT License
+        Copyright (c) 2024
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Project-URL: Homepage, https://github.com/yourusername/mcp-db
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastmcp>=0.1.0
+Requires-Dist: mysql-connector-python>=8.0.26
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: cryptography>=3.4.7
+Requires-Dist: typing-extensions>=4.0.0
+Dynamic: license-file
+# MySQL Navigator MCP
+A powerful MySQL/MariaDB database navigation tool using MCP (Model Control Protocol) for easy database querying and management.
+## Features
+- Connect to MySQL/MariaDB databases
+- Switch between different databases dynamically
+- Execute SQL queries with type safety
+- Retrieve database schema information
+- Pydantic model validation for query parameters
+- Secure credential management
+- Comprehensive logging system
+- Connection pooling and retry mechanisms
+- SSL/TLS support for secure connections
+## Log File Location (Cross-Platform)
+By default, all logs are written to:
+- **Windows:** `C:\Users\<YourUsername>\.mcp\mcp-db.log`
+- **macOS/Linux:** `/home/<yourusername>/.mcp/mcp-db.log` or `/Users/<yourusername>/.mcp/mcp-db.log`
+If the `.mcp` folder does not exist in your home directory, the application will automatically create it. If you run into any issues, you can manually create the folder:
+**Windows:**
+```powershell
+mkdir $env:USERPROFILE\.mcp
+```
+**macOS/Linux:**
+```bash
+mkdir -p ~/.mcp
+```
+## Installation
+### From PyPI (recommended for most users):
+```bash
+pip install mcp-db-navigator
+```
+### From source (for development):
+```bash
+git clone <your-repo-url>
+cd mcp-db
+pip install -e .
+```
+3. Create a `.env` file with your database credentials:
+```env
+DB_HOST=your_host
+DB_PORT=your_port
+DB_NAME=your_database_name
+DB_USER=your_username
+DB_PASSWORD=your_password
+DB_SSL_CA=/path/to/ssl/ca.pem  # Optional: for SSL/TLS connections
+DB_MAX_RETRIES=3  # Optional: number of connection retries
+DB_RETRY_DELAY=1.0  # Optional: delay between retries in seconds
+```
+## Usage Examples
+### 1. Command Line
+Run the MCP server directly from your terminal:
+```bash
+mcp-db --config /path/to/your/project/.env
+```
+### 2. In Cursor
+To use this MCP server in [Cursor](https://www.cursor.so):
+- Open Cursor settings and add a new MCP server.
+- Use the following configuration (example):
+```json
+{
+  "mcpServers": {
+    "mysql-navigator": {
+      "command": "mcp-db",
+      "args": [
+        "--config",
+        "/absolute/path/to/your/.env"
+      ]
+    }
+  }
+}
+```
+- Make sure the path to your `.env` file is absolute.
+### 3. In Claude Desktop
+If Claude Desktop supports MCP servers:
+- Add a new MCP server and point it to the `mcp-db` command with the `--config` argument as above.
+- Refer to Claude Desktop's documentation for details on adding custom MCP servers.
+## Query Parameters
+The query dictionary supports the following parameters:
+- `table_name` (required): Name of the table to query
+- `select_fields` (optional): List of fields to select (defaults to ["*"])
+- `where_conditions` (optional): Dictionary of field-value pairs for WHERE clause
+- `order_by` (optional): List of fields to order by
+- `order_direction` (optional): Sort direction "ASC" or "DESC" (default: "ASC")
+- `limit` (optional): Number of records to return
+- `offset` (optional): Number of records to skip
+- `group_by` (optional): List of fields to group by
+- `having` (optional): Dictionary of field-value pairs for HAVING clause
+- `join_table` (optional): Name of the table to join with
+- `join_type` (optional): Type of JOIN operation (default: "INNER")
+- `join_conditions` (optional): Dictionary of join conditions
+## Security Features
+- Database credentials are managed through a config file
+- Passwords are stored as SecretStr in Pydantic models
+- Input validation for all query parameters
+- SQL injection prevention through parameterized queries
+- SSL/TLS support for encrypted connections
+- Connection string sanitization
+- Rate limiting for queries
+- Query parameter sanitization
+## Production Features
+### Error Handling
+- Comprehensive error handling for database operations
+- Connection timeout handling
+- Automatic retry mechanism for failed connections
+- Input validation for all parameters
+### Performance
+- Connection pooling for optimal resource usage
+- Query execution time logging
+- Connection pool statistics
+- Performance metrics collection
+### Monitoring
+- Structured logging with different log levels
+- Query execution tracking
+- Connection state monitoring
+- Error rate tracking
+## Contributing
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+## License
+This project is licensed under the MIT License - see the LICENSE file for details.

iflow_mcp_mcp_db_navigator-1.0.2/README.md ADDED Viewed

@@ -0,0 +1,152 @@
+# MySQL Navigator MCP
+A powerful MySQL/MariaDB database navigation tool using MCP (Model Control Protocol) for easy database querying and management.
+## Features
+- Connect to MySQL/MariaDB databases
+- Switch between different databases dynamically
+- Execute SQL queries with type safety
+- Retrieve database schema information
+- Pydantic model validation for query parameters
+- Secure credential management
+- Comprehensive logging system
+- Connection pooling and retry mechanisms
+- SSL/TLS support for secure connections
+## Log File Location (Cross-Platform)
+By default, all logs are written to:
+- **Windows:** `C:\Users\<YourUsername>\.mcp\mcp-db.log`
+- **macOS/Linux:** `/home/<yourusername>/.mcp/mcp-db.log` or `/Users/<yourusername>/.mcp/mcp-db.log`
+If the `.mcp` folder does not exist in your home directory, the application will automatically create it. If you run into any issues, you can manually create the folder:
+**Windows:**
+```powershell
+mkdir $env:USERPROFILE\.mcp
+```
+**macOS/Linux:**
+```bash
+mkdir -p ~/.mcp
+```
+## Installation
+### From PyPI (recommended for most users):
+```bash
+pip install mcp-db-navigator
+```
+### From source (for development):
+```bash
+git clone <your-repo-url>
+cd mcp-db
+pip install -e .
+```
+3. Create a `.env` file with your database credentials:
+```env
+DB_HOST=your_host
+DB_PORT=your_port
+DB_NAME=your_database_name
+DB_USER=your_username
+DB_PASSWORD=your_password
+DB_SSL_CA=/path/to/ssl/ca.pem  # Optional: for SSL/TLS connections
+DB_MAX_RETRIES=3  # Optional: number of connection retries
+DB_RETRY_DELAY=1.0  # Optional: delay between retries in seconds
+```
+## Usage Examples
+### 1. Command Line
+Run the MCP server directly from your terminal:
+```bash
+mcp-db --config /path/to/your/project/.env
+```
+### 2. In Cursor
+To use this MCP server in [Cursor](https://www.cursor.so):
+- Open Cursor settings and add a new MCP server.
+- Use the following configuration (example):
+```json
+{
+  "mcpServers": {
+    "mysql-navigator": {
+      "command": "mcp-db",
+      "args": [
+        "--config",
+        "/absolute/path/to/your/.env"
+      ]
+    }
+  }
+}
+```
+- Make sure the path to your `.env` file is absolute.
+### 3. In Claude Desktop
+If Claude Desktop supports MCP servers:
+- Add a new MCP server and point it to the `mcp-db` command with the `--config` argument as above.
+- Refer to Claude Desktop's documentation for details on adding custom MCP servers.
+## Query Parameters
+The query dictionary supports the following parameters:
+- `table_name` (required): Name of the table to query
+- `select_fields` (optional): List of fields to select (defaults to ["*"])
+- `where_conditions` (optional): Dictionary of field-value pairs for WHERE clause
+- `order_by` (optional): List of fields to order by
+- `order_direction` (optional): Sort direction "ASC" or "DESC" (default: "ASC")
+- `limit` (optional): Number of records to return
+- `offset` (optional): Number of records to skip
+- `group_by` (optional): List of fields to group by
+- `having` (optional): Dictionary of field-value pairs for HAVING clause
+- `join_table` (optional): Name of the table to join with
+- `join_type` (optional): Type of JOIN operation (default: "INNER")
+- `join_conditions` (optional): Dictionary of join conditions
+## Security Features
+- Database credentials are managed through a config file
+- Passwords are stored as SecretStr in Pydantic models
+- Input validation for all query parameters
+- SQL injection prevention through parameterized queries
+- SSL/TLS support for encrypted connections
+- Connection string sanitization
+- Rate limiting for queries
+- Query parameter sanitization
+## Production Features
+### Error Handling
+- Comprehensive error handling for database operations
+- Connection timeout handling
+- Automatic retry mechanism for failed connections
+- Input validation for all parameters
+### Performance
+- Connection pooling for optimal resource usage
+- Query execution time logging
+- Connection pool statistics
+- Performance metrics collection
+### Monitoring
+- Structured logging with different log levels
+- Query execution tracking
+- Connection state monitoring
+- Error rate tracking
+## Contributing
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+## License
+This project is licensed under the MIT License - see the LICENSE file for details.

iflow_mcp_mcp_db_navigator-1.0.2/iflow_mcp_mcp_db_navigator.egg-info/PKG-INFO ADDED Viewed

@@ -0,0 +1,189 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_mcp-db-navigator
+Version: 1.0.2
+Summary: A powerful MySQL/MariaDB database navigation tool using MCP (Model Control Protocol).
+Author-email: "Ahmed S. Said-ahmed" <ahmed@pharoslab.net>
+License: MIT License
+        Copyright (c) 2024
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Project-URL: Homepage, https://github.com/yourusername/mcp-db
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastmcp>=0.1.0
+Requires-Dist: mysql-connector-python>=8.0.26
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: cryptography>=3.4.7
+Requires-Dist: typing-extensions>=4.0.0
+Dynamic: license-file
+# MySQL Navigator MCP
+A powerful MySQL/MariaDB database navigation tool using MCP (Model Control Protocol) for easy database querying and management.
+## Features
+- Connect to MySQL/MariaDB databases
+- Switch between different databases dynamically
+- Execute SQL queries with type safety
+- Retrieve database schema information
+- Pydantic model validation for query parameters
+- Secure credential management
+- Comprehensive logging system
+- Connection pooling and retry mechanisms
+- SSL/TLS support for secure connections
+## Log File Location (Cross-Platform)
+By default, all logs are written to:
+- **Windows:** `C:\Users\<YourUsername>\.mcp\mcp-db.log`
+- **macOS/Linux:** `/home/<yourusername>/.mcp/mcp-db.log` or `/Users/<yourusername>/.mcp/mcp-db.log`
+If the `.mcp` folder does not exist in your home directory, the application will automatically create it. If you run into any issues, you can manually create the folder:
+**Windows:**
+```powershell
+mkdir $env:USERPROFILE\.mcp
+```
+**macOS/Linux:**
+```bash
+mkdir -p ~/.mcp
+```
+## Installation
+### From PyPI (recommended for most users):
+```bash
+pip install mcp-db-navigator
+```
+### From source (for development):
+```bash
+git clone <your-repo-url>
+cd mcp-db
+pip install -e .
+```
+3. Create a `.env` file with your database credentials:
+```env
+DB_HOST=your_host
+DB_PORT=your_port
+DB_NAME=your_database_name
+DB_USER=your_username
+DB_PASSWORD=your_password
+DB_SSL_CA=/path/to/ssl/ca.pem  # Optional: for SSL/TLS connections
+DB_MAX_RETRIES=3  # Optional: number of connection retries
+DB_RETRY_DELAY=1.0  # Optional: delay between retries in seconds
+```
+## Usage Examples
+### 1. Command Line
+Run the MCP server directly from your terminal:
+```bash
+mcp-db --config /path/to/your/project/.env
+```
+### 2. In Cursor
+To use this MCP server in [Cursor](https://www.cursor.so):
+- Open Cursor settings and add a new MCP server.
+- Use the following configuration (example):
+```json
+{
+  "mcpServers": {
+    "mysql-navigator": {
+      "command": "mcp-db",
+      "args": [
+        "--config",
+        "/absolute/path/to/your/.env"
+      ]
+    }
+  }
+}
+```
+- Make sure the path to your `.env` file is absolute.
+### 3. In Claude Desktop
+If Claude Desktop supports MCP servers:
+- Add a new MCP server and point it to the `mcp-db` command with the `--config` argument as above.
+- Refer to Claude Desktop's documentation for details on adding custom MCP servers.
+## Query Parameters
+The query dictionary supports the following parameters:
+- `table_name` (required): Name of the table to query
+- `select_fields` (optional): List of fields to select (defaults to ["*"])
+- `where_conditions` (optional): Dictionary of field-value pairs for WHERE clause
+- `order_by` (optional): List of fields to order by
+- `order_direction` (optional): Sort direction "ASC" or "DESC" (default: "ASC")
+- `limit` (optional): Number of records to return
+- `offset` (optional): Number of records to skip
+- `group_by` (optional): List of fields to group by
+- `having` (optional): Dictionary of field-value pairs for HAVING clause
+- `join_table` (optional): Name of the table to join with
+- `join_type` (optional): Type of JOIN operation (default: "INNER")
+- `join_conditions` (optional): Dictionary of join conditions
+## Security Features
+- Database credentials are managed through a config file
+- Passwords are stored as SecretStr in Pydantic models
+- Input validation for all query parameters
+- SQL injection prevention through parameterized queries
+- SSL/TLS support for encrypted connections
+- Connection string sanitization
+- Rate limiting for queries
+- Query parameter sanitization
+## Production Features
+### Error Handling
+- Comprehensive error handling for database operations
+- Connection timeout handling
+- Automatic retry mechanism for failed connections
+- Input validation for all parameters
+### Performance
+- Connection pooling for optimal resource usage
+- Query execution time logging
+- Connection pool statistics
+- Performance metrics collection
+### Monitoring
+- Structured logging with different log levels
+- Query execution tracking
+- Connection state monitoring
+- Error rate tracking
+## Contributing
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+## License
+This project is licensed under the MIT License - see the LICENSE file for details.

iflow_mcp_mcp_db_navigator-1.0.2/iflow_mcp_mcp_db_navigator.egg-info/SOURCES.txt ADDED Viewed

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+iflow_mcp_mcp_db_navigator.egg-info/PKG-INFO
+iflow_mcp_mcp_db_navigator.egg-info/SOURCES.txt
+iflow_mcp_mcp_db_navigator.egg-info/dependency_links.txt
+iflow_mcp_mcp_db_navigator.egg-info/entry_points.txt
+iflow_mcp_mcp_db_navigator.egg-info/requires.txt
+iflow_mcp_mcp_db_navigator.egg-info/top_level.txt
+mcp_db/__init__.py
+mcp_db/connection_pool.py
+mcp_db/db.py
+mcp_db/metrics.py
+mcp_db/security.py
+mcp_db/server.py

iflow_mcp_mcp_db_navigator-1.0.2/iflow_mcp_mcp_db_navigator.egg-info/dependency_links.txt ADDED Viewed

	@@ -0,0 +1 @@
1	+

iflow_mcp_mcp_db_navigator-1.0.2/iflow_mcp_mcp_db_navigator.egg-info/entry_points.txt ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ [console_scripts]
2	+ mcp-db = mcp_db.server:main_cli

iflow_mcp_mcp_db_navigator-1.0.2/iflow_mcp_mcp_db_navigator.egg-info/requires.txt ADDED Viewed

@@ -0,0 +1,5 @@
+fastmcp>=0.1.0
+mysql-connector-python>=8.0.26
+pydantic>=2.0.0
+cryptography>=3.4.7
+typing-extensions>=4.0.0

iflow_mcp_mcp_db_navigator-1.0.2/iflow_mcp_mcp_db_navigator.egg-info/top_level.txt ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ dist
2	+ mcp_db

iflow_mcp_mcp_db_navigator-1.0.2/mcp_db/__init__.py ADDED Viewed

File without changes

iflow_mcp_mcp_db_navigator-1.0.2/mcp_db/connection_pool.py ADDED Viewed

@@ -0,0 +1,84 @@
+from mysql.connector import pooling, Error
+import logging
+from typing import Any
+from mcp_db.db import DatabaseCredentials
+from mcp_db.security import SecurityManager
+logger = logging.getLogger(__name__)
+class ConnectionPool:
+    _instance = None
+    _pool = None
+    def __new__(cls):
+        if cls._instance is None:
+            cls._instance = super(ConnectionPool, cls).__new__(cls)
+        return cls._instance
+    def __init__(self):
+        self.pool_name = "mysql_pool"
+        self.pool_size = 5
+        self.security_manager = SecurityManager()
+    def initialize_pool(self, credentials: DatabaseCredentials) -> None:
+        """Initialize the connection pool with given credentials"""
+        if self._pool is not None:
+            logger.warning("Pool already initialized")
+            return
+        try:
+            # Get SSL context if SSL CA is provided
+            ssl_context = self.security_manager.get_ssl_context(credentials.ssl_ca)
+            pool_config = {
+                "pool_name": self.pool_name,
+                "pool_size": self.pool_size,
+                "host": credentials.host,
+                "port": credentials.port,
+                "database": credentials.database,
+                "user": credentials.username,
+                "password": credentials.password.get_secret_value(),
+                "connect_timeout": 10,  # 10 seconds timeout
+                "use_pure": True,  # Use pure Python implementation
+            }
+            # Add SSL configuration if available
+            if ssl_context:
+                pool_config.update(ssl_context)
+                logger.info("SSL/TLS connection enabled")
+            # Remove None values
+            pool_config = {k: v for k, v in pool_config.items() if v is not None}
+            self._pool = pooling.MySQLConnectionPool(**pool_config)
+            logger.info(f"Connection pool initialized with size {self.pool_size}")
+        except Error as e:
+            logger.error(f"Failed to initialize connection pool: {e}")
+            raise
+    def get_connection(self) -> Any:
+        """Get a connection from the pool"""
+        if self._pool is None:
+            raise RuntimeError("Pool not initialized. Call initialize_pool first.")
+        try:
+            connection = self._pool.get_connection()
+            logger.debug("Retrieved connection from pool")
+            return connection
+        except Error as e:
+            logger.error(f"Failed to get connection from pool: {e}")
+            raise
+    def close_all(self) -> None:
+        """Close all connections in the pool"""
+        if self._pool is not None:
+            try:
+                # Close all connections
+                self._pool._remove_connections()
+                logger.info("All connections in pool closed")
+            except Error as e:
+                logger.error(f"Error closing pool connections: {e}")
+                raise
+            finally:
+                self._pool = None