Mysql MCP Server

🚀 MySQL MCP 服務器

MySQL MCP 服務器為 MySQL 數據庫打造了模型上下文協議（MCP）接口，讓 AI 模型能借助結構化接口與 MySQL 數據庫交互，支持 Web 服務器和 CLI 兩種運行模式，為數據庫操作帶來便利。

🚀 快速開始

MySQL MCP 服務器有兩種使用方式，您可以選擇使用 Smithery.ai 上發佈的服務器，也可以使用本地安裝版本。

使用 Smithery.ai 上發佈的服務器

1. 訪問服務器：訪問 https://smithery.ai/server/@sussa3007/mysql-mcp
2. 配置服務器：設置 MySQL 數據庫連接參數，如 MYSQL_HOST、MYSQL_PORT、MYSQL_USER、MYSQL_PASSWORD、MYSQL_DATABASE，MYSQL_READONLY（可選，默認為 True 表示只讀訪問）。
3. 與支持的 AI 平臺連接：可連接 Anthropic Claude、Cursor AI、Windsurf 等多個 AI 平臺。
4. 身份驗證：登錄 Smithery.ai 以保存配置並生成認證令牌。
5. 在 AI 提示中使用：連接後，在 AI 對話中請求執行數據庫操作即可使用 MySQL 工具。

使用本地安裝版本

# 安裝依賴
npm install mysql-mcp
# 運行服務器
mysql-mcp

默認情況下，服務器將在 http://localhost:3000 上運行，您可以訪問 /api-docs 查看 API 文檔。

✨ 主要特性

• MySQL 數據庫連接管理
• SQL 查詢執行
• 表格列表及結構檢查
• 數據庫列表及選擇
• 即時狀態監控通過 SSE（服務器發送事件）
• 提供用於測試 MCP 工具的 Web 接口
• 支持 stdio 和 SSE 兩種傳輸方式
• Docker 部署就緒

📦 安裝指南

# 全局安裝
npm install -g mysql-mcp

# 本地安裝
npm install mysql-mcp

💻 使用示例

基礎用法

# 本地安裝
npm install mysql-mcp
# 運行服務器
mysql-mcp

📚 詳細文檔

工具 - MCP 服務

功能

/ping

• 方法：GET
• 描述：檢查服務是否可用
• 響應：

  {
    "status": "ok"
  }
  

/query

• 方法：POST
• 路徑：/query
• 請求體：

  {
    "sql": "string" // 需要執行的 SQL 查詢
  }
  

• 響應體：

  {
    "results": [...] // 查詢結果
  }
  

📄 許可證

本項目採用 MIT 許可證。

關鍵字

mysql, mcp, 數據庫, ai, 模型上下文協議