@berthojoris/mcp-mysql-server 1.0.0 → 1.0.2

package/README.md

@@ -2,7 +2,7 @@
 
 A fully-featured **Model Context Protocol (MCP)** server for MySQL database integration with AI agents like Claude Desktop, Cline, Windsurf, and other MCP-compatible tools.
 
-[![npm version](https://img.shields.io/npm/v/@modelcontextprotocol/server-mysql)](https://www.npmjs.com/package/@modelcontextprotocol/server-mysql)
+[![npm version](https://img.shields.io/npm/v/@berthojoris/mcp-mysql-server)](https://www.npmjs.com/package/@berthojoris/mcp-mysql-server)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 ---
@@ -28,22 +28,13 @@ A fully-featured **Model Context Protocol (MCP)** server for MySQL database inte
 No installation needed! Use directly with npx:
 
 ```bash
-npx @modelcontextprotocol/server-mysql mysql://user:pass@localhost:3306/db "list,read,utility"
+npx @berthojoris/mcp-mysql-server mysql://user:pass@localhost:3306/db "list,read,utility"
 ```
 
-### Option 2: Clone and Build
+### Option 2: Global Installation
 
 ```bash
-git clone <your-repo-url>
-cd mcp_mysql
-npm install
-npm run build
-```
-
-### Option 3: Global Installation
-
-```bash
-npm install -g @modelcontextprotocol/server-mysql
+npm install -g @berthojoris/mcp-mysql-server
 mcp-mysql mysql://user:pass@localhost:3306/db "list,read,utility"
 ```
 
@@ -80,15 +71,16 @@ npm run build
 - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
 
-**Configuration:**
+**Configuration (using npx - recommended):**
 
 ```json
 {
   "mcpServers": {
     "mysql": {
-      "command": "node",
+      "command": "npx",
       "args": [
-        "C:\\path\\to\\mcp_mysql\\bin\\mcp-mysql.js",
+        "-y",
+        "@berthojoris/mcp-mysql-server",
         "mysql://user:password@localhost:3306/database",
         "list,read,utility"
       ]
@@ -97,16 +89,15 @@ npm run build
 }
 ```
 
-**Or use npx (if published):**
+**Alternative: Local development (if you cloned the repository):**
 
 ```json
 {
   "mcpServers": {
     "mysql": {
-      "command": "npx",
+      "command": "node",
       "args": [
-        "-y",
-        "@modelcontextprotocol/server-mysql",
+        "C:\\path\\to\\mysql-mcp\\bin\\mcp-mysql.js",
         "mysql://user:password@localhost:3306/database",
         "list,read,utility"
       ]
@@ -276,17 +267,19 @@ You can have different databases with different permissions in the same AI agent
 {
   "mcpServers": {
     "mysql-prod": {
-      "command": "node",
+      "command": "npx",
       "args": [
-        "C:\\path\\to\\bin\\mcp-mysql.js",
+        "-y",
+        "@berthojoris/mcp-mysql-server",
         "mysql://reader:pass@prod-server:3306/prod_db",
         "list,read,utility"
       ]
     },
     "mysql-dev": {
-      "command": "node",
+      "command": "npx",
       "args": [
-        "C:\\path\\to\\bin\\mcp-mysql.js",
+        "-y",
+        "@berthojoris/mcp-mysql-server",
         "mysql://root:pass@localhost:3306/dev_db",
         "list,read,create,update,delete,execute,ddl,utility"
       ]
@@ -907,7 +900,10 @@ curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
 ### Test MCP Server Locally
 
 ```bash
-# Test connection
+# Test connection using npx (recommended)
+npx -y @berthojoris/mcp-mysql-server mysql://user:pass@localhost:3306/test "list,read,utility"
+
+# Or if you cloned the repository locally
 node bin/mcp-mysql.js mysql://user:pass@localhost:3306/test "list,read,utility"
 ```
 
@@ -941,7 +937,7 @@ To make your MCP server available to the world:
   "author": "Your Name <your.email@example.com>",
   "repository": {
     "type": "git",
-    "url": "https://github.com/your-username/mcp-mysql.git"
+    "url": "https://github.com/berthojoris/mysql-mcp.git"
   }
 }
 ```
@@ -979,8 +975,9 @@ npx @your-username/mcp-mysql mysql://user:pass@localhost:3306/db "list,read,util
 **Solutions:**
 1. Check config file path is correct
 2. Restart AI agent completely  
-3. Verify bin/mcp-mysql.js exists
-4. Check for JSON syntax errors
+3. If using npx: Verify internet connection for package download
+4. If using local files: Verify bin/mcp-mysql.js exists
+5. Check for JSON syntax errors
 
 **Problem:** Connection fails
 
@@ -1028,7 +1025,7 @@ FLUSH PRIVILEGES;
 ### Project Structure
 
 ```
-mcp_mysql/
+mysql-mcp/
 ├── src/
 │   ├── config/         # Configuration and permissions
 │   ├── db/             # Database connection
@@ -1103,8 +1100,8 @@ MIT License - see [LICENSE](LICENSE) file for details.
 
 ## 💬 Support
 
-- **Issues:** [GitHub Issues](https://github.com/your-username/mcp-mysql/issues)
-- **Discussions:** [GitHub Discussions](https://github.com/your-username/mcp-mysql/discussions)
+- **Issues:** [GitHub Issues](https://github.com/berthojoris/mysql-mcp/issues)
+- **Discussions:** [GitHub Discussions](https://github.com/berthojoris/mysql-mcp/discussions)
 - **Documentation:** This README
 
 ---

package/bin/mcp-mysql.js

@@ -60,7 +60,7 @@ try {
   
 } catch (error) {
   console.error('Error parsing MySQL URL:', error.message);
-  console.error('Usage: npx @modelcontextprotocol/server-mysql mysql://user:password@host:port/dbname');
+  console.error('Usage: npx @berthojoris/mcp-mysql-server mysql://user:password@host:port/dbname');
   process.exit(1);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@berthojoris/mcp-mysql-server",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Model Context Protocol server for MySQL database integration with dynamic per-project permissions",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -35,16 +35,16 @@
     "mysql-client",
     "ai-tools"
   ],
-  "author": "Your Name <your.email@example.com>",
+  "author": "Bertho Joris <berthojoris@gmail.com>",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/your-username/mcp-mysql.git"
+    "url": "https://github.com/berthojoris/mysql-mcp.git"
   },
   "bugs": {
-    "url": "https://github.com/your-username/mcp-mysql/issues"
+    "url": "https://github.com/berthojoris/mysql-mcp/issues"
   },
-  "homepage": "https://github.com/your-username/mcp-mysql#readme",
+  "homepage": "https://github.com/berthojoris/mysql-mcp#readme",
   "files": [
     "dist",
     "bin",