使用说明

项目简介

Platform Management 系统是一个用于管理 IT 架构的平台。它包含一个嵌入式的 SQLite MCP Server,旨在让 LLM 客户端(如 Cursor)能够与 SQLite 数据库进行交互。此 MCP 服务器充当桥梁,使 LLM 能够执行 SQL 查询并分析 SQLite 数据库中的数据。

主要功能点

  • SQLite 数据库访问: 通过 MCP 协议向 LLM 客户端提供 SQLite 数据库的访问能力。
  • SQL 查询执行: 允许 LLM 客户端执行 SQL 查询并检索 SQLite 数据库中的数据。
  • 数据分析支持: 方便 LLM 在 SQLite 数据库上进行数据分析和生成洞察报告。
  • Docker 部署: 使用 Docker 容器化部署,简化 MCP 服务器的安装和运行。

安装步骤

  1. 克隆仓库:

    git clone https://github.com/Malnati/platform-management.git
    cd platform-management
  2. 安装依赖:

    npm install
  3. 构建并启动 SQLite MCP Server (需要 Docker):

    cd .docker
    docker-compose build
    docker-compose up -d

服务器配置 (MCP 客户端)

要将 MCP 客户端(例如 Cursor)连接到此 SQLite MCP 服务器,您需要在客户端中配置服务器的启动命令。将以下 JSON 配置添加到您的 MCP 客户端设置中(例如,Cursor 的 'claude_desktop_config.json'):

{
  "mcpServers": {
    "sqlite": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "sqlite-data:/mcp",
        "platform-management-sqlite-mcp",
        "--db-path",
        "/mcp/platform-management.db"
      ]
    }
  }
}

配置参数说明:

  • 'server name': 'sqlite' (或者您在客户端配置中用于标识此服务器的任何名称)
  • 'command': 'docker' (指定使用 Docker 运行服务器)
  • 'args':
    • 'run': Docker 命令,用于运行容器
    • '--rm': 容器退出时自动删除容器
    • '-i': 即使未连接也保持 STDIN 打开
    • '-v sqlite-data:/mcp': 将名为 'sqlite-data' 的 Docker 卷挂载到容器内的 '/mcp' (用于持久化数据库存储)
    • 'platform-management-sqlite-mcp': SQLite MCP 服务器的 Docker 镜像名称
    • '--db-path /mcp/platform-management.db': 传递给服务器的参数,用于指定容器内的数据库文件路径。

基本使用方法

  1. 启动 MCP 服务器: 确保 MCP 服务器正在使用 Docker 运行(在 '.docker' 目录中运行 'docker-compose up -d')。
  2. 配置 MCP 客户端: 使用提供的 JSON 配置配置您的 MCP 客户端(例如 Cursor)。
  3. 在 LLM 客户端中交互: 在您的 LLM 客户端中,启动 MCP 交互(例如,在 Cursor 中,使用 MCP 图标并选择相关的提示,如 "mcp-demo")。
  4. 与 SQLite 数据库交互: 按照 LLM 的指示与 SQLite 数据库进行交互。您可以提问、执行 SQL 查询和分析数据。

信息

分类

数据库与文件