MySQL MCP Server

Integrations

  • Enables secure interaction with MySQL databases, allowing listing of tables, reading data, and executing SQL queries through a controlled interface for database exploration and analysis.

MySQL MCP 服务器

一个模型上下文协议 (MCP) 服务器,可实现与 MySQL 数据库的安全交互。该服务器允许 AI 助手通过受控界面列出表格、读取数据并执行 SQL 查询,从而使数据库探索和分析更加安全、结构化。

特征

  • 列出可用的 MySQL 表作为资源
  • 读取表内容
  • 执行 SQL 查询并进行适当的错误处理
  • 通过环境变量保护数据库访问
  • 综合日志记录

配置

设置以下环境变量:

MYSQL_HOST=localhost # Database host MYSQL_PORT=3306 # Optional: Database port (defaults to 3306 if not specified) MYSQL_USER=your_username MYSQL_PASSWORD=your_password MYSQL_DATABASE=your_database

用法

使用 Claude Desktop

将其添加到您的claude_desktop_config.json中:

{ "mcpServers": { "mysql": { "command": "python", "args": [ "-m", "src.mysql_mcp_server.server" ], "env": { "MYSQL_HOST": "localhost", "MYSQL_PORT": "3306", "MYSQL_USER": "your_username", "MYSQL_PASSWORD": "your_password", "MYSQL_DATABASE": "your_database" } } } }

作为独立服务器

# Clone the repository git clone https://github.com/designcomputer/mysql_mcp_server.git cd mysql_mcp_server # Install dependencies pip install -r requirements.txt # Run the server python -m src.mysql_mcp_server.server

发展

# Clone the repository git clone https://github.com/designcomputer/mysql_mcp_server.git cd mysql_mcp_server # Create virtual environment python -m venv py-mcp-mysql_venv source py-mcp-mysql_venv/bin/activate # or `py-mcp-mysql_venv\Scripts\activate` on Windows # Install development dependencies pip install -r requirements-dev.txt # Run tests pytest

安全注意事项

  • 切勿提交环境变量或凭据
  • 使用具有最低所需权限的数据库用户
  • 考虑实施查询白名单以供生产使用
  • 监控并记录所有数据库操作

安全最佳实践

此 MCP 服务器需要数据库访问权限才能运行。出于安全考虑:

  1. 创建具有最小权限的专用 MySQL 用户
  2. 切勿使用根凭据或管理帐户
  3. 将数据库访问限制为仅进行必要的操作
  4. 启用日志记录以用于审计目的
  5. 定期对数据库访问进行安全审查

有关以下方面的详细说明,请参阅MySQL 安全配置指南

  • 创建受限 MySQL 用户
  • 设置适当的权限
  • 监控数据库访问
  • 安全最佳实践

⚠️重要提示:配置数据库访问时始终遵循最小特权原则。

执照

MIT 许可证 - 详情请参阅 LICENSE 文件。

贡献

  1. 分叉存储库
  2. 创建你的功能分支( git checkout -b feature/amazing-feature
  3. 提交您的更改( git commit -m 'Add some amazing feature'
  4. 推送到分支( git push origin feature/amazing-feature
  5. 打开拉取请求
-
security - not tested
F
license - not found
-
quality - not tested

实现与 MySQL 数据库的安全交互,允许 AI 助手通过受控界面列出表格、读取数据和执行 SQL 查询。

  1. Features
    1. Configuration
      1. Usage
        1. With Claude Desktop
        2. As a standalone server
      2. Development
        1. Security Considerations
          1. Security Best Practices
            1. License
              1. Contributing
                ID: 8ua52m2qhi