mysqldb-mcp-server MCP服务器

这是一个MySQL数据库MCP服务器项目。

安装

你可以使用uv来安装该包：

uv pip install mysqldb-mcp-server

或者使用pip：

pip install mysqldb-mcp-server

组件

工具

服务器提供了两个工具：

• connect_database：连接到特定的MySQL数据库

  • database参数：要连接的数据库名称（字符串）
  • 成功连接后返回确认消息

• execute_query：执行MySQL查询

  • query参数：要执行的SQL查询/查询（字符串）
  • 返回JSON格式的查询结果
  • 可以通过分号分隔发送多个查询

配置

服务器使用以下环境变量：

• MYSQL_HOST：MySQL服务器地址（默认："localhost"）
• MYSQL_USER：MySQL用户名（默认："root"）
• MYSQL_PASSWORD：MySQL密码（默认：""）
• MYSQL_DATABASE：初始数据库（可选）
• MYSQL_READONLY：只读模式（设置为1/true启用，默认：false）

快速开始

安装

Claude桌面

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows: %APPDATA%/Claude/claude_desktop_config.json

<details> <summary>开发/未发布服务器配置</summary>

{
  "mcpServers": {
    "mysqldb-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/burakdirin/Projects/mysqldb-mcp-server",
        "run",
        "mysqldb-mcp-server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "password",
        "MYSQL_DATABASE": "[可选]",
        "MYSQL_READONLY": "true"
      }
    }
  }
}

</details> <details> <summary>已发布服务器配置</summary>

{
  "mcpServers": {
    "mysqldb-mcp-server": {
      "command": "uvx",
      "args": [
        "mysqldb-mcp-server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "password",
        "MYSQL_DATABASE": "[可选]",
        "MYSQL_READONLY": "true"
      }
    }
  }
}

</details>

通过Smithery安装

要通过Smithery自动安装MySQL数据库集成服务器到Claude桌面：

npx -y @smithery/cli install @burakdirin/mysqldb-mcp-server --client claude

开发

构建与发布

为了准备分发包：

1. 同步依赖并更新锁文件：

uv sync

2. 构建包分布：

uv build

这将在dist/目录中创建源和轮子分布。

3. 发布到PyPI：

uv publish

注意：你需要通过环境变量或命令标志设置PyPI凭证：

• Token：--token 或 UV_PUBLISH_TOKEN
• 或用户名/密码：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于MCP服务器通过标准I/O运行，调试可能会很困难。为了获得最佳的调试体验，我们强烈推荐使用MCP Inspector。

你可以通过npm使用以下命令启动MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory /Users/burakdirin/Projects/mysqldb-mcp-server run mysqldb-mcp-server

启动后，Inspector会显示一个URL，你可以在浏览器中访问该URL开始调试。