MCP Servers Mysql

MySQL MCP服务器包装器

模型上下文协议（MCP）MySQL服务器的轻量级可配置包装器。该项目允许AI助手和MCP客户端安全地连接到MySQL数据库并与之交互。它旨在作为将本地或远程数据库暴露给MCP兼容工具的起点。

🌟 特性

• 简易设置：包装标准 mcp-server-mysql 包裹。
• 连接测试：包括一个内置的诊断脚本(test-connection.js)在开始之前验证数据库连接。
• 灵活的配置：在单个环境变量或连接字符串之间进行选择，以配置数据库访问。
• 代理就绪：已准备好供AI代理用于读取模式和查询数据。

📋 先决条件

• （建议使用版本14或更高版本）
• MySQL数据库

🚀 安装

1. 克隆存储库 （如果你还没有）：

   git clone 
   cd 

1. 安装依赖项:

   npm install

⚙️ 配置

有两种方法可以配置数据库连接。你只需要选择一个。

选项1：编辑 index-mcp.js （为清楚起见，建议使用）

打开 index-mcp.js 并更新值以匹配您的数据库凭据：

process.env.MYSQL_HOST = "127.0.0.1"; // Your database host
process.env.MYSQL_PORT = "3306";      // Your database port
process.env.MYSQL_USER = "your_user"; // Your database username
process.env.MYSQL_PASS = "your_pass"; // Your database password
process.env.MYSQL_DB = "your_db_name"; // Your database name

选项2：编辑 start-mcp.js （紧凑型）

打开 start-mcp.js 并更新连接URL：

// Format: mysql://user:password@host:port/database_name
process.env.DATABASE_URL = "mysql://your_user:your_pass@127.0.0.1:3306/your_db_name";

🔒 安全提示：强烈建议使用以下命令创建特定的数据库用户 只读 （SELECT）用于此目的的权限。这可以防止MCP代理意外修改或删除您的数据。

🛠️ 用法

1.验证连接

在运行服务器之前，请通过运行测试脚本检查您的凭据是否正确：

node test-connection.js

• 如果成功，您将看到 ✅ SUCCESS! 消息。
• 如果失败，脚本将输出详细的错误消息以帮助您进行调试。

2.启动服务器

运行您在上一步中配置的方法。

如果配置了选项1：

node index-mcp.js

如果配置了选项2：

node start-mcp.js

📂 项目结构

• index-mcp.js：使用单个配置变量的主服务器入口点。
• start-mcp.js：使用单个连接URL的替代入口点。
• test-connection.js：用于独立于MCP服务器测试数据库连接的实用程序脚本。
• package.json：项目依赖关系。

🛠️ 用法

反重力人工智能中的MCP服务器示例代码

{
  "mcpServers": {
    "mysql-pos": {
      "command": "node",
      "args": [
        "/var/www/html/mcp-servers/index-mcp.js"
      ]
    }
  }
}

🤝 贡献

如果您有改进或错误修复，请随时分叉此存储库并提交拉取请求。