mcp-server-mysql-py 0.1.0__tar.gz

mcp_server_mysql_py-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+.npm-cache
+**/run.log
+!.env.example
+.idea
+.env.pro
+.vscode
+deploy.sh

mcp_server_mysql_py-0.1.0/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.4
+Name: mcp-server-mysql-py
+Version: 0.1.0
+Summary: A Python MCP server for MySQL database queries
+License: MIT
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pymysql>=1.1.0
+Description-Content-Type: text/markdown
+
+# mcp-server-mysql-py
+
+A Python MCP server for MySQL database queries.
+
+## Installation
+
+```bash
+pip install mcp-server-mysql-py
+```
+
+## Configuration
+
+Set environment variables:
+
+- `MYSQL_HOST` - Database host (default: 127.0.0.1)
+- `MYSQL_PORT` - Database port (default: 3306)
+- `MYSQL_USER` - Database user (default: root)
+- `MYSQL_PASS` - Database password
+- `MYSQL_DB` - Database name
+
+## Usage
+
+### MCP Client Configuration
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "mcp-server-mysql-py",
+      "env": {
+        "MYSQL_HOST": "127.0.0.1",
+        "MYSQL_PORT": "3306",
+        "MYSQL_USER": "root",
+        "MYSQL_PASS": "password",
+        "MYSQL_DB": "mydb"
+      }
+    }
+  }
+}
+```
+
+### Tools
+
+- **mysql_query** - Execute SQL queries
+- **mysql_tables** - List all tables
+- **mysql_describe** - Show table columns

mcp_server_mysql_py-0.1.0/README.md

@@ -0,0 +1,46 @@
+# mcp-server-mysql-py
+
+A Python MCP server for MySQL database queries.
+
+## Installation
+
+```bash
+pip install mcp-server-mysql-py
+```
+
+## Configuration
+
+Set environment variables:
+
+- `MYSQL_HOST` - Database host (default: 127.0.0.1)
+- `MYSQL_PORT` - Database port (default: 3306)
+- `MYSQL_USER` - Database user (default: root)
+- `MYSQL_PASS` - Database password
+- `MYSQL_DB` - Database name
+
+## Usage
+
+### MCP Client Configuration
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "mcp-server-mysql-py",
+      "env": {
+        "MYSQL_HOST": "127.0.0.1",
+        "MYSQL_PORT": "3306",
+        "MYSQL_USER": "root",
+        "MYSQL_PASS": "password",
+        "MYSQL_DB": "mydb"
+      }
+    }
+  }
+}
+```
+
+### Tools
+
+- **mysql_query** - Execute SQL queries
+- **mysql_tables** - List all tables
+- **mysql_describe** - Show table columns

mcp_server_mysql_py-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mcp-server-mysql-py"
+version = "0.1.0"
+description = "A Python MCP server for MySQL database queries"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+dependencies = [
+    "mcp>=1.0.0",
+    "pymysql>=1.1.0",
+]
+
+[project.scripts]
+mcp-server-mysql-py = "mcp_server_mysql.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mcp_server_mysql"]

mcp_server_mysql_py-0.1.0/src/mcp_server_mysql/__init__.py

@@ -0,0 +1 @@
+"""MCP Server for MySQL database queries."""

mcp_server_mysql_py-0.1.0/src/mcp_server_mysql/server.py

@@ -0,0 +1,135 @@
+"""MCP Server for MySQL - Python implementation."""
+
+import json
+import os
+import sys
+from typing import Any
+
+import pymysql
+from mcp.server import Server
+from mcp.server.stdio import stdio_server
+from mcp.types import TextContent, Tool
+
+# ── 配置 ──────────────────────────────────────────────
+MYSQL_HOST = os.environ.get("MYSQL_HOST", "127.0.0.1")
+MYSQL_PORT = int(os.environ.get("MYSQL_PORT", "3306"))
+MYSQL_USER = os.environ.get("MYSQL_USER", "root")
+MYSQL_PASS = os.environ.get("MYSQL_PASS", "")
+MYSQL_DB = os.environ.get("MYSQL_DB", "")
+
+
+def get_connection() -> pymysql.Connection:
+    return pymysql.connect(
+        host=MYSQL_HOST,
+        port=MYSQL_PORT,
+        user=MYSQL_USER,
+        password=MYSQL_PASS,
+        database=MYSQL_DB,
+        charset="utf8mb4",
+        cursorclass=pymysql.cursors.DictCursor,
+    )
+
+
+def execute_query(sql: str) -> list[dict[str, Any]]:
+    conn = get_connection()
+    try:
+        with conn.cursor() as cursor:
+            cursor.execute(sql)
+            if cursor.description:  # 有结果集
+                return cursor.fetchall()
+            else:  # INSERT/UPDATE/DELETE
+                conn.commit()
+                return [{"affected_rows": cursor.rowcount}]
+    except Exception as e:
+        conn.rollback()
+        raise e
+    finally:
+        conn.close()
+
+
+# ── MCP Server ────────────────────────────────────────
+server = Server("mcp-server-mysql-py")
+
+
+@server.list_tools()
+async def list_tools() -> list[Tool]:
+    return [
+        Tool(
+            name="mysql_query",
+            description="Execute a SQL query against the MySQL database",
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "sql": {
+                        "type": "string",
+                        "description": "The SQL query to execute",
+                    }
+                },
+                "required": ["sql"],
+            },
+        ),
+        Tool(
+            name="mysql_tables",
+            description="List all tables in the current database",
+            inputSchema={
+                "type": "object",
+                "properties": {},
+            },
+        ),
+        Tool(
+            name="mysql_describe",
+            description="Show columns of a specific table",
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "table": {
+                        "type": "string",
+                        "description": "The table name to describe",
+                    }
+                },
+                "required": ["table"],
+            },
+        ),
+    ]
+
+
+@server.call_tool()
+async def call_tool(name: str, arguments: dict) -> list[TextContent]:
+    try:
+        if name == "mysql_query":
+            sql = arguments["sql"]
+            rows = execute_query(sql)
+            result = json.dumps(rows, default=str, ensure_ascii=False)
+            return [TextContent(type="text", text=result)]
+
+        elif name == "mysql_tables":
+            rows = execute_query("SHOW TABLES")
+            tables = [list(row.values())[0] for row in rows]
+            return [TextContent(type="text", text="\n".join(tables))]
+
+        elif name == "mysql_describe":
+            table = arguments["table"]
+            rows = execute_query(f"DESCRIBE `{table}`")
+            result = json.dumps(rows, default=str, ensure_ascii=False)
+            return [TextContent(type="text", text=result)]
+
+        else:
+            return [TextContent(type="text", text=f"Unknown tool: {name}")]
+
+    except Exception as e:
+        return [TextContent(type="text", text=f"Error: {e}")]
+
+
+# ── 入口 ──────────────────────────────────────────────
+async def _run():
+    async with stdio_server() as (read_stream, write_stream):
+        await server.run(read_stream, write_stream, server.create_initialization_options())
+
+
+def main():
+    import asyncio
+    asyncio.run(_run())
+
+
+if __name__ == "__main__":
+    main()