mcp-dbutils 0.2.3__py3-none-any.whl → 0.2.4__py3-none-any.whl

{mcp_dbutils-0.2.3.dist-info → mcp_dbutils-0.2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-dbutils
-Version: 0.2.3
+Version: 0.2.4
 Summary: MCP Database Utilities Service
 Author: Dong Hao
 License-Expression: MIT
@@ -16,7 +16,7 @@ Description-Content-Type: text/markdown
 
 ![GitHub Repo stars](https://img.shields.io/github/stars/donghao1393/mcp-dbutils)
 ![PyPI version](https://img.shields.io/pypi/v/mcp-dbutils)
-![Python versions](https://img.shields.io/pypi/pyversions/mcp-dbutils)
+![Python](https://img.shields.io/badge/Python-3.10%2B-blue)
 ![License](https://img.shields.io/github/license/donghao1393/mcp-dbutils)
 
 [中文文档](README_CN.md)
@@ -45,9 +45,16 @@ uvx mcp-dbutils --config /path/to/config.yaml
 Add to Claude configuration:
 ```json
 "mcpServers": {
-  "database": {
+  "dbutils": {
     "command": "uvx",
-    "args": ["mcp-dbutils", "--config", "/path/to/config.yaml"]
+    "args": [
+      "mcp-dbutils",
+      "--config",
+      "/path/to/config.yaml"
+    ],
+    "env": {
+      "MCP_DEBUG": "1"  // Optional: Enable debug mode
+    }
   }
 }
 ```
@@ -60,9 +67,17 @@ pip install mcp-dbutils
 Add to Claude configuration:
 ```json
 "mcpServers": {
-  "database": {
+  "dbutils": {
     "command": "python",
-    "args": ["-m", "mcp_dbutils", "--config", "/path/to/config.yaml"]
+    "args": [
+      "-m",
+      "mcp_dbutils",
+      "--config",
+      "/path/to/config.yaml"
+    ],
+    "env": {
+      "MCP_DEBUG": "1"  // Optional: Enable debug mode
+    }
   }
 }
 ```
@@ -71,16 +86,28 @@ Add to Claude configuration:
 ```bash
 docker run -i --rm \
   -v /path/to/config.yaml:/app/config.yaml \
+  -e MCP_DEBUG=1 \  # Optional: Enable debug mode
   mcp/dbutils --config /app/config.yaml
 ```
 
 Add to Claude configuration:
 ```json
 "mcpServers": {
-  "database": {
+  "dbutils": {
     "command": "docker",
-    "args": ["run", "-i", "--rm", "-v", "/path/to/config.yaml:/app/config.yaml", 
-             "mcp/dbutils", "--config", "/app/config.yaml"]
+    "args": [
+      "run",
+      "-i",
+      "--rm",
+      "-v",
+      "/path/to/config.yaml:/app/config.yaml",
+      "mcp/dbutils",
+      "--config",
+      "/app/config.yaml"
+    ],
+    "env": {
+      "MCP_DEBUG": "1"  // Optional: Enable debug mode
+    }
   }
 }
 ```
@@ -117,6 +144,23 @@ Set environment variable `MCP_DEBUG=1` to enable debug mode for detailed logging
 ## Architecture Design
 
 ### Core Concept: Abstraction Layer
+
+```mermaid
+graph TD
+  Client[Client] --> DatabaseServer[Database Server]
+  subgraph MCP Server
+    DatabaseServer
+    DatabaseHandler[Database Handler]
+    PostgresHandler[PostgreSQL Handler]
+    SQLiteHandler[SQLite Handler]
+    DatabaseServer --> DatabaseHandler
+    DatabaseHandler --> PostgresHandler
+    DatabaseHandler --> SQLiteHandler
+  end
+  PostgresHandler --> PostgreSQL[(PostgreSQL)]
+  SQLiteHandler --> SQLite[(SQLite)]
+```
+
 The abstraction layer design is the core architectural concept in MCP Database Utilities. Just like a universal remote control that works with different devices, users only need to know the basic operations without understanding the underlying complexities.
 
 #### 1. Simplified User Interaction
@@ -216,3 +260,26 @@ Provides SQLite-specific features:
 - File path handling
 - URI scheme support
 - Password protection support (optional)
+
+## Contributing
+Contributions are welcome! Here's how you can help:
+
+1. 🐛 Report bugs: Open an issue describing the bug and how to reproduce it
+2. 💡 Suggest features: Open an issue to propose new features
+3. 🛠️ Submit PRs: Fork the repo and create a pull request with your changes
+
+### Development Setup
+1. Clone the repository
+2. Create a virtual environment using `uv venv`
+3. Install dependencies with `uv sync --all-extras`
+4. Run tests with `pytest`
+
+For detailed guidelines, see [CONTRIBUTING.md](.github/CONTRIBUTING.md)
+
+## Acknowledgments
+- [MCP Servers](https://github.com/modelcontextprotocol/servers) for inspiration and demonstration
+- AI Editors:
+  * [Claude Desktop](https://claude.ai/download)
+  * [5ire](https://5ire.app/)
+  * [Cline](https://cline.bot)
+- [Model Context Protocol](https://modelcontextprotocol.io/) for comprehensive interfaces

{mcp_dbutils-0.2.3.dist-info → mcp_dbutils-0.2.4.dist-info}/RECORD

@@ -10,8 +10,8 @@ mcp_dbutils/sqlite/__init__.py,sha256=QV4th2ywzUmCCa3GHCcBf8blJ_E8OYy0dJ2fSf1TfS
 mcp_dbutils/sqlite/config.py,sha256=QK1JlY-ZBB5VyhydbiU-aAKNESTWMtyBfawbv2DAVCQ,2452
 mcp_dbutils/sqlite/handler.py,sha256=v2fFHxepNSUuK65UPo4fwyeBCDG6fit5IuLdBRIKUsY,4220
 mcp_dbutils/sqlite/server.py,sha256=Q29O2YOW4kqDGc3z1hMXVv4M0KSkuZbqvVDMgZE8Fd8,7593
-mcp_dbutils-0.2.3.dist-info/METADATA,sha256=TqDZw19V4rPsI5zS89McSFqHBSk73KOWTiaS3tE3dzw,6051
-mcp_dbutils-0.2.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mcp_dbutils-0.2.3.dist-info/entry_points.txt,sha256=XTjt0QmYRgKOJQT6skR9bp1EMUfIrgpHeZJPZ3CJffs,49
-mcp_dbutils-0.2.3.dist-info/licenses/LICENSE,sha256=1A_CwpWVlbjrKdVEYO77vYfnXlW7oxcilZ8FpA_BzCI,1065
-mcp_dbutils-0.2.3.dist-info/RECORD,,
+mcp_dbutils-0.2.4.dist-info/METADATA,sha256=Eq2rC77Wrf6UAUSiJVhWNU0N-nQKZw7rSUadOD5Bm4Y,7718
+mcp_dbutils-0.2.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mcp_dbutils-0.2.4.dist-info/entry_points.txt,sha256=XTjt0QmYRgKOJQT6skR9bp1EMUfIrgpHeZJPZ3CJffs,49
+mcp_dbutils-0.2.4.dist-info/licenses/LICENSE,sha256=1A_CwpWVlbjrKdVEYO77vYfnXlW7oxcilZ8FpA_BzCI,1065
+mcp_dbutils-0.2.4.dist-info/RECORD,,