日志查询分析服务

一个基于PostgreSQL数据库的模型上下文协议(MCP)服务器,用于查询和分析用户活动日志,提供日志获取和报告生成功能。

  • by jfbarahonag
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 jfbarahonag/mcp-logs

使用说明

📊 MCP 日志

一个用于从PostgreSQL数据库查询和分析用户活动日志的模型上下文协议(MCP)服务器。

✨ 特点

这个MCP服务器提供了两个主要工具:

  • get_user_logs 📋 - 通过文档ID获取用户日志,可选日期范围过滤和结果限制
  • build_report 📄 - 使用Jinja2模板生成包含日志摘要和分析的Markdown报告

📋 前提条件

  • npm(Node Package Manager)
  • Python >= 3.13(Python版本大于等于3.13)
  • PostgreSQL 数据库

🗄️ 数据库设置

  1. 运行 Docker Compose
  2. 从db.sql加载数据
  3. 保存凭据以备后用

🚀 安装说明

  1. git clone https://github.com/jfbarahonag/mcp-logs.git

  2. cd mcp-logs

  3. 按下连接按钮

  4. 复制服务器条目

  5. 在MCP用户配置中粘贴,并使用logs_mcp作为键

  6. 将项目的绝对路径添加为 server.py 的前缀

  7. 从 .env.example 文件创建 .env 文件,将 TEMPLATES_DIR 设置为 templates 目录,并配置数据库连接字符串

  8. 启动MCP服务器

  9. 随时可用! ✅

  10. 选择MCP并开始聊天💬