使用说明
项目简介
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 服务器的安装和运行。
安装步骤
-
克隆仓库:
git clone https://github.com/Malnati/platform-management.git cd platform-management -
安装依赖:
npm install -
构建并启动 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': 传递给服务器的参数,用于指定容器内的数据库文件路径。
基本使用方法
- 启动 MCP 服务器: 确保 MCP 服务器正在使用 Docker 运行(在 '.docker' 目录中运行 'docker-compose up -d')。
- 配置 MCP 客户端: 使用提供的 JSON 配置配置您的 MCP 客户端(例如 Cursor)。
- 在 LLM 客户端中交互: 在您的 LLM 客户端中,启动 MCP 交互(例如,在 Cursor 中,使用 MCP 图标并选择相关的提示,如 "mcp-demo")。
- 与 SQLite 数据库交互: 按照 LLM 的指示与 SQLite 数据库进行交互。您可以提问、执行 SQL 查询和分析数据。
信息
分类
数据库与文件