Konflux DevLake MCP 服务器

一个允许通过自然语言查询Konflux DevLake数据库的MCP服务器。此服务器作为AI助手与您的DevLake数据库之间的桥梁，使您能够用自然语言提问并获得结构化数据。

📚 文档

• 完整架构文档 - 完整系统架构和设计模式
• 文档索引 - 视觉图表和文档目录
• 架构图 - 使用Mermaid格式的系统图

快速开始

方案 1：Python（开发）

1. 安装依赖项：

pip install -r requirements.txt

2. 启动服务器：

python konflux-devlake-mcp.py --transport http --host 0.0.0.0 --port 3000 --db-host localhost --db-port 3306 --db-user root --db-password password --db-database lake

方案 2：Docker（生产）

1. 构建Docker镜像：

docker build -t konflux-devlake-mcp:latest .

2. 运行容器：

docker run -d \
  --name konflux-mcp-server \
  -p 3000:3000 \
  -e DB_HOST=your_db_host \
  -e DB_PORT=3306 \
  -e DB_USER=root \
  -e DB_PASSWORD=your_password \
  -e DB_DATABASE=lake \
  -e LOG_LEVEL=INFO \
  konflux-devlake-mcp:latest

3. 推送至仓库（如有需要）：

docker tag konflux-devlake-mcp:latest quay.io/flacatus/mcp-lake:1.0.0
docker push quay.io/flacatus/mcp-lake:1.0.0

配置

命令行参数

参数	描述	示例
--transport	传输协议（stdio/http）	--transport http
--host	服务器主机	--host 0.0.0.0
--port	服务器端口	--port 3000
--db-host	数据库主机	--db-host localhost
--db-port	数据库端口	--db-port 3306
--db-user	数据库用户名	--db-user root
--db-password	数据库密码	--db-password your_password
--db-database	数据库名称	--db-database lake
--log-level	日志级别	--log-level INFO

环境变量（替代方案）

export DB_HOST=localhost
export DB_PORT=3306
export DB_USER=root
export DB_PASSWORD=your_password
export DB_DATABASE=lake
export TRANSPORT=http
export SERVER_HOST=0.0.0.0
export SERVER_PORT=3000
export LOG_LEVEL=INFO

然后运行：

python konflux-devlake-mcp.py

帮助命令

python konflux-devlake-mcp.py --help

可用工具

此服务器提供了几个专门用于处理您的DevLake数据的工具：

• 数据库工具：连接到您的数据库，列出可用的数据库和表，执行自定义SQL查询，并获取详细的表结构
• 事件分析：获取独特的事件并自动去重，分析事件模式，并跟踪解决时间
• 部署跟踪：通过高级过滤监控部署数据，跟踪部署频率，并分析服务分布

特性

• 自然语言处理：自动将普通英语问题转换为SQL查询
• 安全第一：内置SQL注入检测和全面的查询验证以保护您的数据
• DevLake集成：专门用于分析来自Konflux DevLake的事件和部署数据的工具
• 灵活传输：支持HTTP和stdio传输协议
• 全面日志：详细的日志记录，包括轮换和错误跟踪，用于调试和监控

安全

您的数据安全是我们优先考虑的事项：

• SQL注入防护：自动检测和防止潜在的SQL注入攻击
• 查询验证：每个查询在执行前都会被验证和清理
• 数据屏蔽：敏感信息会在查询结果中自动屏蔽
• 访问控制：数据库级别的访问控制确保只有授权操作被执行

监控

跟踪您的服务器健康状况和性能：

• 应用程序日志：logs/konflux_devlake_mcp_server.log - 通用服务器活动和操作
• 错误日志：logs/konflux_devlake_mcp_server_error.log - 详细的错误信息用于故障排除
• 健康检查：GET http://localhost:3000/health - 监控服务器状态和连通性

贡献

我们欢迎对改进此项目的贡献：

1. 分叉存储库
2. 为您的更改创建一个特性分支
3. 进行改进并添加测试
4. 提交带有清晰更改描述的拉取请求

使用场景

此MCP服务器特别适用于：

• 数据分析师：快速查询DevLake数据而无需编写复杂的SQL
• DevOps团队：通过自然语言查询监控事件和部署
• AI助手：启用AI工具访问和分析您的DevLake数据
• 商业智能：从您的DevLake数据库生成报告和洞察
• 开发团队：调试和分析应用性能数据