GitHub Stats

    Stars

    4

    Forks

    4

    Release Date

    3/21/2025

    about 3 months ago

    Detailed Description

    MCP MySQL 本地数据库服务

    MCP MySQL服务是一个轻量级的个人使用服务程序,用于连接和操作本地MySQL数据库。此服务可作为Cursor的MCP服务使用,通过API接口使Cursor能够轻松地执行各种数据库操作。

    特性

    • 连接本地MySQL数据库
    • 提供RESTful API进行数据库操作
    • 支持参数化查询防止SQL注入
    • 支持SSE (Server-Sent Events) 推送能力
    • 支持作为Cursor MCP服务集成

    快速开始

    前置条件

    • Node.js (v14+)
    • MySQL服务器

    安装

    1. 克隆此仓库
    2. 安装依赖
      npm install
      
    3. 创建并配置.env文件
      # 服务器配置
      PORT=3000
      NODE_ENV=development
      
      # MySQL数据库配置
      DB_HOST=localhost
      DB_PORT=3306
      DB_USER=你的用户名
      DB_PASSWORD=你的密码
      DB_NAME=你的数据库名
      
      # API配置
      API_KEY=你的API密钥
      

    运行

    npm start
    

    开发模式(自动重启):

    npm run dev
    

    API接口

    获取所有数据库

    GET /api/databases
    

    获取数据库的所有表

    GET /api/databases/:database/tables
    

    获取表结构

    GET /api/databases/:database/tables/:table/structure
    

    执行查询

    POST /api/query
    Content-Type: application/json
    
    {
      "sql": "SELECT * FROM users WHERE age > ?",
      "params": [18],
      "limit": 10,
      "offset": 0
    }
    

    SSE连接

    GET /api/sse?apiKey=your-api-key
    

    在Cursor中使用

    SSE方式

    {
      "name": "MySQL数据库服务",
      "url": "http://localhost:3000/api/sse",
      "type": "sse"
    }
    

    Command方式

    {
      "name": "MySQL数据库服务",
      "command": "node /path/to/mcp_server_mysql/src/app.js",
      "type": "command"
    }
    

    安全性考虑

    • 此服务仅限本地使用,不建议暴露到公网
    • 使用API密钥保护接口
    • 默认只允许执行SELECT查询

    许可证

    MIT

    About the Project

    This app has not been claimed by its owner yet.

    Claim Ownership

    Receive Updates

    Security Updates

    Get notified about trust rating changes

    to receive email notifications.