MCP Mysql App

🚀 MySQL MCP 工具服務器

這是一個藉助 AI 接口與 MySQL 數據庫進行交互的 Model Context Protocol (MCP) 工具服務器實現。它為 AI 系統提供了便捷的方式來連接和查詢 MySQL 數據庫，極大地提升了數據交互的效率。

🚀 快速開始

該項目提供了一組工具，允許 AI 系統通過 Model Context Protocol 連接到並查詢 MySQL 數據庫。它使 AI 助手能夠執行 SQL 查詢並檢查數據庫連接狀態。

✨ 主要特性

• 簡單而強大的 MySQL 工具集成
• 類型安全的工具定義
• 增強的錯誤處理
• 支持處理請求終止信號
• 會話感知

📦 安裝指南

1. 克隆此倉庫
2. 安裝依賴：

npm install

💻 使用示例

基礎用法

遊標配置

在遊標中使用時，您需要在 settings.json 文件中進行以下設置：

{
  "mcpMySQL": {
    "host": "localhost",
    "port": 3306,
    "user": "root",
    "password": "password"
  }
}

其他 AI 平臺配置

在其他 AI 平臺中使用時，您需要根據平臺的要求進行相應的配置。通常，您需要提供 MySQL 連接信息（主機、端口、用戶和密碼）。

高級用法

在 AI 環境中使用 MySQL 工具

一旦您配置好了 MySQL 工具，在您的 AI 環境中就可以開始使用它們。以下是示例：

• 使用遊標中的 MySQL 工具：在遊標中，您可以簡單地提示 Claude 執行與 MySQL 相關的任務：
  • 檢查連接是否正常工作："檢查 MySQL 連接是否正常工作。"
  • 查看所有數據庫："顯示此 MySQL 服務器上的所有數據庫。"
  • 查看錶："列出當前數據庫中的所有表。"
  • 查詢數據："顯示用戶表的前 10 條記錄。"
  • 創建表："創建一個名為 'products' 的新表，其中包含 id、名稱、價格和描述列。"
  • 插入數據："插入一個新的產品，其名稱為 '智能手機'，價格為 499.99，描述為 '最新型號'。"
  • 更新記錄："將 '智能手機' 產品的價格更新為 449.99。"

這些示例展示瞭如何通過 AI 助手自然地與 MySQL 交互，一旦工具配置正確。

📚 詳細文檔

可用工具

• sql_check_connection：檢查 MySQL 連接是否正常工作
• sql_query：在連接的數據庫上執行 SQL 查詢

支持和幫助

如果您在使用此工具時遇到問題，請執行以下操作：

• 檢查您的 MySQL 連接詳細信息是否正確
• 確保 Node.js 已正確安裝
• 檢查您在 AI 平臺中的 MCP 配置
• 查看日誌文件中可能顯示的任何錯誤消息
• 驗證到 MySQL 服務器的網絡連接

📄 許可證

此項目 licensed under the MIT License，詳細信息請參閱 LICENSE 文件。