Update README.md

Update README to clarify MySQL MCP Server's usage

- Removed instructions for running server directly with Python
- Added section about using MCP Inspector for debugging
- Clarified that the server is not meant to be run standalone
- Emphasized integration with AI applications like Claude Desktop
- Updated terminology from "server" to "implementation" to better
  reflect the component's nature as a protocol implementation

Author: designcomputer

README.md

@@ -1,36 +1,31 @@
 ![Tests](https://github.com/designcomputer/mysql_mcp_server/actions/workflows/test.yml/badge.svg)
 [![smithery badge](https://smithery.ai/badge/mysql-mcp-server)](https://smithery.ai/server/mysql-mcp-server)
 # MySQL MCP Server
+A Model Context Protocol (MCP) implementation that enables secure interaction with MySQL databases. This server component facilitates communication between AI applications (hosts/clients) and MySQL databases, making database exploration and analysis safer and more structured through a controlled interface.
 
-A Model Context Protocol (MCP) server that enables secure interaction with MySQL databases. This server allows AI assistants to list tables, read data, and execute SQL queries through a controlled interface, making database exploration and analysis safer and more structured.
+> **Note**: MySQL MCP Server is not designed to be used as a standalone server, but rather as a communication protocol implementation between AI applications and MySQL databases.
 
 ## Features
-
 - List available MySQL tables as resources
 - Read table contents
 - Execute SQL queries with proper error handling
 - Secure database access through environment variables
 - Comprehensive logging
 
 ## Installation
-
 ### Manual Installation
 ```bash
 pip install mysql-mcp-server
 ```
 
 ### Installing via Smithery
-
-To install MySQL Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/mysql-mcp-server):
-
+To install MySQL MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/mysql-mcp-server):
 ```bash
 npx -y @smithery/cli install mysql-mcp-server --client claude
 ```
 
 ## Configuration
-
 Set the following environment variables:
-
 ```bash
 MYSQL_HOST=localhost     # Database host
 MYSQL_PORT=3306         # Optional: Database port (defaults to 3306 if not specified)
@@ -40,11 +35,8 @@ MYSQL_DATABASE=your_database
 ```
 
 ## Usage
-
 ### With Claude Desktop
-
 Add this to your `claude_desktop_config.json`:
-
 ```json
 {
   "mcpServers": {
@@ -68,45 +60,41 @@ Add this to your `claude_desktop_config.json`:
 }
 ```
 
-### As a standalone server
+### Debugging with MCP Inspector
+While MySQL MCP Server isn't intended to be run standalone or directly from the command line with Python, you can use the MCP Inspector to debug it.
+
+The MCP Inspector provides a convenient way to test and debug your MCP implementation:
 
 ```bash
 # Install dependencies
 pip install -r requirements.txt
-
-# Run the server
-python -m mysql_mcp_server
+# Use the MCP Inspector for debugging (do not run directly with Python)
 ```
 
-## Development
+The MySQL MCP Server is designed to be integrated with AI applications like Claude Desktop and should not be run directly as a standalone Python program.
 
+## Development
 ```bash
 # Clone the repository
 git clone https://github.com/yourusername/mysql_mcp_server.git
 cd mysql_mcp_server
-
 # Create virtual environment
 python -m venv venv
 source venv/bin/activate  # or `venv\Scripts\activate` on Windows
-
 # Install development dependencies
 pip install -r requirements-dev.txt
-
 # Run tests
 pytest
 ```
 
 ## Security Considerations
-
 - Never commit environment variables or credentials
 - Use a database user with minimal required permissions
 - Consider implementing query whitelisting for production use
 - Monitor and log all database operations
 
 ## Security Best Practices
-
-This MCP server requires database access to function. For security:
-
+This MCP implementation requires database access to function. For security:
 1. **Create a dedicated MySQL user** with minimal permissions
 2. **Never use root credentials** or administrative accounts
 3. **Restrict database access** to only necessary operations
@@ -122,11 +110,9 @@ See [MySQL Security Configuration Guide](https://github.com/designcomputer/mysql
 ⚠️ IMPORTANT: Always follow the principle of least privilege when configuring database access.
 
 ## License
-
 MIT License - see LICENSE file for details.
 
 ## 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'`)