Английский [中]]

Для китайской документации см. README.zh-CN.md

Сервер Model Context Protocol, обеспечивающий работу баз данных MySQL. Этот сервер позволяет моделям ИИ взаимодействовать с базами данных MySQL через стандартизированный интерфейс.

##Установка

###Установка через Smithery

Установить MySQL Server для Claude Desktop автоматически через Smithery

Ручная установка

Конфигурация

Сервер требует, чтобы следующие переменные среды были установлены в файле конфигурации настроек MCP:

Рекомендуемое использование

##Бегущий Эвалс

Пакет evals загружает клиент mcp, который затем запускает файл index.ts, поэтому нет необходимости перестраиваться между тестами. Вы можете загрузить переменные среды, предварительно закрепив команду npx. Полную документацию можно найти здесь.

Доступные инструменты

###1, соединить db Установите соединение с базой данных MySQL с использованием предоставленных учетных данных.

###2 - запрос Выполнять запросы SELECT с дополнительными подготовленными параметрами заявления.

###3, исполнять Выполняйте запросы INSERT, UPDATE или DELETE с дополнительными подготовленными параметрами заявления.

###4.Список Перечислите все таблицы в подключенной базе данных.

###5 Опишите таблица

@fhuang/mcp-mysql-server

[English | 中文文档]

---

For Chinese documentation, please see README.zh-CN.md

---

A Model Context Protocol server that provides MySQL database operations. This server enables AI models to interact with MySQL databases through a standardized interface.

Installation

Installing via Smithery

To install MySQL Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @fhuang/mcp-mysql-server --client claude

Manual Installation

npx @fhuang/mcp-mysql-server

Configuration

The server requires the following environment variables to be set in your MCP settings configuration file:

recommended use

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "@fhuang/mcp-mysql-server", "mysql://user:password@localhost:port/database"],
    }
  }
}

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "@fhuang/mcp-mysql-server"],
      "env": {
        "MYSQL_HOST": "your_host",
        "MYSQL_USER": "your_user",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

Running evals

The evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the npx command. Full documentation can be found here.

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

Available Tools

1. connect_db

Establish connection to MySQL database using provided credentials.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "connect_db",
  arguments: {
    host: "localhost",
    user: "your_user",
    password: "your_password",
    database: "your_database"
  }
});

2. query

Execute SELECT queries with optional prepared statement parameters.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "query",
  arguments: {
    sql: "SELECT * FROM users WHERE id = ?",
    params: [1]
  }
});

3. execute

Execute INSERT, UPDATE, or DELETE queries with optional prepared statement parameters.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "execute",
  arguments: {
    sql: "INSERT INTO users (name, email) VALUES (?, ?)",
    params: ["John Doe", "[email protected]"]
  }
});

4. list_tables

List all tables in the connected database.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "list_tables",
  arguments: {}
});

5. describe_table

Get the structure of a specific table.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "describe_table",
  arguments: {
    table: "users"