平台事件分析服务

一个统一的接口,用于查询和分析TimelyCare微服务生态系统中的平台事件,提供基于MCP协议的AI辅助事件分析功能。

  • by PeterSurowski
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 PeterSurowski/ai-event-search

使用说明

代码挑战:平台事件智能

用于跨TimelyCare微服务生态系统查询和分析平台事件的统一界面。公开用于AI辅助事件分析的MCP(模型上下文协议)服务器。

概述

该服务从各种来源(部署、事件、配置更改、警报)获取事件,并通过MCP工具提供关键字和语义搜索功能。

主要特点

  • 多租户架构 -事件范围为具有基于令牌的授权的服务
  • 双搜索模式 -关键字(SQL)和语义(pgvector)搜索
  • MCP接口 -AI代理和助手查询平台事件的工具

快速开始

# Start PostgreSQL with pgvector
docker compose up -d

# Install dependencies
bun install

# Run migrations and seed data
bun run db:reset

# Start MCP server
bun run mcp:dev

MCP工具

工具 说明
search_events 按关键字或语义相似性搜索事件
get_event_details 获取特定活动的完整详细信息
get_service_timeline 获取服务的按时间顺序排列的事件时间线

配置

复制 .env.example 到 .env 并配置:

# Database
DB_HOST=localhost
DB_PORT=5432
DB_USER=pei
DB_PASSWORD=pei_dev_password
DB_NAME=platform_events

# OpenAI (optional - mock embeddings used if not set)
OPENAI_API_KEY=

# Auth token for MCP tools
PEI_AUTH_TOKEN=

发展

bun run dev          # Start API server (watch mode)
bun run mcp:dev      # Start MCP server (watch mode)
bun run mcp:inspect  # MCP Inspector for testing tools
bun test             # Run tests
bun run typecheck    # Type checking

建筑

看 CLAUDE.md 了解详细的架构文档和代码约定。

许可证

专有-TimelyCare仅供内部使用