MCP 服务器：MySQL 实现指南

安装方法

使用 Smithery 进行安装

smithery install @benborla/mcp-server-mysql

使用 MCP Get 进行安装

mcp-get install @benborla/mcp-server-mysql

配置说明

根据文档中提供的配置选项，您可以选择以下方式设置环境变量：

设置 PATH 环境变量（可选）

export PATH="/path/to/node/bin:$PATH"

配置示例

{
  "env": {
    "NODE_OPTIONS": "--loader ts-node/index",
    "PATH": "/path/to/node/bin:/usr/bin:/bin"
  }
}

测试指南

数据库准备

1. 创建测试用户和数据库

   CREATE USER 'mcp_test'@'localhost' IDENTIFIED BY 'mcp_test_password';
   GRANT ALL PRIVILEGES ON mcp_test.* TO 'mcp_test'@'localhost';
   FLUSH PRIVILEGES;
   

2. 运行数据库脚本

   pnpm run setup:test:db
   

3. 创建测试环境文件

   在项目根目录下创建.env.test文件：

   MYSQL_HOST=127.0.0.1
   MYSQL_PORT=3306
   MYSQL_USER=mcp_test
   MYSQL_PASS=mcp_test_password
   MYSQL_DB=mcp_test
   

更新 package.json

在 package.json 中添加以下脚本：

{
  "scripts": {
    "setup:test:db": "ts-node scripts/setup-test-db.ts",
    "pretest": "pnpm run setup:test:db",
    "test": "vitest run",
    "test:watch": "vitest",
    "test:coverage": "vitest run --coverage"
  }
}

执行测试

# 初始化测试环境
pnpm run setup:test:db

# 运行所有测试
pnpm test

故障排除

使用 Smithery 进行诊断

smithery status @benborla/mcp-server-mysql

smithery diagnose @benborla/mcp-server-mysql

smithery logs @benborla/mcp-server-mysql

常见问题

1. 连接问题

   • 确认 MySQL 服务器运行状态。
   • 检查用户权限设置。

2. 性能问题

   • 调整数据库配置参数。
   • 使用更高效的数据查询方式。

3. 版本兼容性

   • 确保 Node.js 和相关工具的版本与项目要求一致。

贡献指南

代码仓库访问

git clone https://github.com/yourusername/mcp-server-mysql.git

开发环境设置

1. 克隆仓库：

   git clone https://github.com/yourusername/mcp-server-mysql.git
   cd mcp-server-mysql
   

2. 安装依赖：

   pnpm install
   

3. 启动开发服务器：

   pnpm dev
   

文档参考

• 官方文档：MCP 服务器文档
• 社区支持：GitHub 仓库

通过以上步骤，您可以轻松完成 MCP 服务器的安装、配置和测试工作。如果有任何问题，请随时参考官方文档或联系社区寻求帮助。