local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Uses environment variables for configuration, allowing database credentials to be securely stored and accessed through a .env file.
Hosts the repository for the MCP server, enabling users to clone and install the server from GitHub.
Provides database interaction capabilities through MySQL, enabling SQL query execution, table management, schema analysis, and business intelligence generation with automatic insights creation.

zaj-MySQL-MCP

模型上下文协议 (MCP) 服务器实现，通过 MySQL 提供数据库交互和商业智能功能。该服务器支持运行 SQL 查询、分析业务数据并自动生成业务洞察备忘录。

特征

对 MySQL 数据库执行 SQL 查询
创建和管理数据库表
分析数据库模式
生成并存储业务洞察
访问持续更新的商业洞察备忘录

工具

查询工具

read_query ：执行 SELECT 查询以从数据库读取数据
- 输入： query （字符串）-要执行的 SELECT SQL 查询
- 返回：查询结果作为对象数组
write_query ：执行 INSERT、UPDATE 或 DELETE 查询
- 输入： query （字符串）- SQL 修改查询
- 返回： { affected_rows: number }
create_table ：在数据库中创建新表
- 输入： query （字符串） - CREATE TABLE SQL 语句
- 返回：表创建确认

架构工具

list_tables ：获取数据库中所有表的列表
- 无需输入
- 返回：表名数组
describe_table ：查看特定表的架构信息
- 输入： table_name （字符串）- 要描述的表的名称
- 返回：具有名称和类型的列定义数组

分析工具

append_insight ：向备忘录资源添加新的业务见解
- 输入： insight （字符串）- 从数据分析中发现的商业洞察
- 返回：确认洞察力的增加
- 触发 memo://insights 资源的更新

资源

服务器公开单个资源：

memo://insights ：持续更新的业务洞察备忘录，汇总分析过程中发现的洞察
- 通过附加洞察工具发现新见解时自动更新

实现细节

此 MCP 服务器直接实现模型上下文协议，无需依赖外部 SDK。它使用：

mysql2 ：用于 MySQL 数据库连接
yargs ：用于命令行参数解析
readline ：用于处理 stdin/stdout 通信

服务器遵循 JSON-RPC 2.0 协议与 Claude 进行通信，处理工具列表、资源列表和工具执行的请求。

配置

MySQL MCP 服务器使用环境变量进行配置。请在根目录中创建一个.env文件，其中包含以下变量：

# Database Connection
DB_CONNECTION=mysql

# Database Host
DB_HOST=localhost

# Database Port
DB_PORT=3306

# Database Username (required)
DB_USER=your_mysql_username

# Database Password (required)
DB_PASSWORD=your_mysql_password

# Database Name (required)
DB_NAME=your_database_name

提供了一个.env.example文件作为模板。将其复制到.env并更新其值：

cp .env.example .env
# Then edit .env with your database credentials

与 Claude Desktop 一起使用

将服务器添加到您的cline_mcp_settings.json ：

"mcpServers": {
  "mysql": {
    "command": "node",
    "args": [
      "/path/to/zaj_MySQL_MCP/build/index.js"
    ],
    "disabled": false,
    "autoApprove": []
  }
}

请注意，数据库凭据现在是通过.env文件配置的，而不是通过命令行参数配置的。

构建和运行

克隆存储库：

git clone https://github.com/zajTools/zaj-MySQL-MCP.git
cd zaj-MySQL-MCP

创建并配置您的 .env 文件：

cp .env.example .env
# Edit .env with your database credentials

安装依赖项：

npm install

构建服务器：

npm run build

运行服务器：

node build/index.js

演示和示例

我们提供了示例材料来帮助您开始使用 MySQL MCP 服务器：

示例数据库：包含客户、产品、订单和销售数据的完整电子商务数据库模式
示例查询：预先编写的查询，演示 MCP 服务器的各种功能
使用场景：Claude 如何与 MySQL 数据库交互的示例

尝试演示：

查看演示指南，了解分步说明
运行安装 SQL 脚本来创建示例数据库
配置 MCP 服务器以连接到演示数据库
开始向 Claude 询问有关您的数据的问题！

这些示例旨在展示使用 Claude 与 MySQL 数据库的潜力，但 MCP 服务器可与您有权访问的任何 MySQL 数据库一起使用。

执照

此 MCP 服务器根据 MIT 许可证获得许可。

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

模型上下文协议服务器，通过 MySQL 连接实现 SQL 查询执行、数据库管理和商业智能功能。

Related Resources

Reddit Discussion about this server