Skip to main content
Glama

AnomalyArmor 에이전트

PyPI npm Glama License: MIT

AnomalyArmor 데이터 관측성을 위한 AI 기술 및 MCP 서버입니다. Claude Code, Cursor 또는 MCP 호환 AI 도구에서 직접 데이터 품질을 모니터링하고, 스키마 드리프트를 감지하며, 알림을 관리하세요.

버전: 0.6.0 | 도구: 52개의 통합 MCP 도구 | 기술: 14개의 슬래시 명령어

빠른 시작

옵션 1: Claude Code 플러그인 (권장)

# Install the plugin
claude plugin marketplace add anomalyarmor/agents
claude plugin install armor@anomalyarmor

# Or via skills.sh
npx skills add anomalyarmor/agents

그런 다음 다음과 같은 기술을 사용하세요:

  • /armor:status - 데이터 상태 확인

  • /armor:alerts - 알림 보기 및 관리

  • /armor:recommend - AI 모니터링 권장 사항 받기

  • /armor:ask - 데이터에 대한 질문하기

옵션 2: MCP 서버

MCP 구성(Claude Code, Cursor 등)에 추가하세요:

{
  "mcpServers": {
    "armor": {
      "command": "uvx",
      "args": ["armor-mcp"]
    }
  }
}

Related MCP server: aegis-dq

사전 요구 사항

  1. AnomalyArmor 계정: anomalyarmor.ai에서 가입하세요.

  2. API 키: 설정 > API 키에서 생성하세요.

  3. 구성: ARMOR_API_KEY 환경 변수를 설정하거나 ~/.armor/config.yaml을 생성하세요:

api_key: aa_live_your_key_here

사용 가능한 기술

기술

설명

예시

/armor:start

신규 사용자를 위한 가이드 온보딩

"설정을 도와줘"

/armor:status

모든 자산의 상태 요약

"데이터가 정상인가요?"

/armor:connect

새로운 데이터 소스 연결

"Snowflake 웨어하우스 연결해줘"

/armor:monitor

신선도 및 스키마 모니터링 설정

"orders 테이블의 신선도 모니터링해줘"

/armor:alerts

알림 쿼리 및 관리

"어제 발생한 알림은 무엇인가요?"

/armor:ask

데이터에 대한 자연어 Q&A

"고객 데이터가 포함된 테이블은 무엇인가요?"

/armor:analyze

AI 분석 트리거

"finance 스키마 분석해줘"

/armor:quality

데이터 품질 지표 및 유효성 규칙

"customer_id에 null 체크 추가해줘"

/armor:coverage

모니터링 범위 분석

"모니터링이 없는 테이블은 무엇인가요?"

/armor:recommend

AI 기반 모니터링 권장 사항

"무엇을 모니터링해야 할까요?"

/armor:tags

자산 태깅 및 분류

"이 테이블을 PII로 태그해줘"

/armor:investigate

근본 원인 분석

"이 테이블이 왜 오래되었나요?"

/armor:lineage

데이터 계보 탐색

"이 테이블에 의존하는 것은 무엇인가요?"

/armor:profile

테이블 프로파일링 및 통계

"orders 테이블 프로파일링해줘"

MCP 도구 (29개 통합)

도구는 통합 패턴을 따릅니다. 도메인당 하나의 도구가 action 매개변수를 통해 여러 작업을 처리하여 컨텍스트 창 사용량을 줄이면서도 전체 기능을 유지합니다.

상태 및 브리핑

  • health_summary() - 모든 자산의 전반적인 데이터 상태

  • get_todays_briefing() - 알림, 신선도 및 범위 공백을 포함한 일일 AI 브리핑

알림 (5개 도구)

  • get_alerts_summary() - 심각도 및 상태별 알림 수

  • list_alerts(status, severity, asset_id, from_date, to_date) - 필터를 사용한 알림 쿼리

  • list_inbox_alerts(status, limit) - 미해결 알림 받은 편지함

  • update_alert(alert_id, action, ...) - 알림 확인, 해결, 일시 중지 또는 댓글 달기

  • get_alert_trends(period) - 시간 경과에 따른 알림 추세

  • get_alert_history(alert_id) - 특정 알림에 대한 전체 기록

알림 규칙 (3개 도구)

  • list_alert_rules(asset_id, is_active) - 구성된 규칙 목록

  • create_alert_rule(asset_id, rule_type, ...) - 새 알림 규칙 생성

  • manage_alert_rule(rule_id, action, ...) - 규칙 업데이트, 삭제, 활성화/비활성화 또는 복제

자산 (3개 도구)

  • list_assets(source, asset_type, search) - 모니터링되는 자산 목록

  • create_asset(name, source_type, connection_config) - 데이터 소스 생성

  • manage_asset(asset_id, action, ...) - 업데이트, 삭제, 연결 테스트 또는 검색 트리거

  • trigger_asset_discovery(asset_id) - 스키마 검색 시작

신선도 (4개 도구)

  • get_freshness_summary() - 모든 자산의 신선도 개요

  • check_freshness(asset_id, table_path) - 특정 테이블 신선도 확인

  • setup_freshness(asset_id, table_path, check_interval, ...) - 신선도 일정 생성

  • list_freshness_schedules(asset_id) - 구성된 일정 목록

  • manage_freshness_schedule(schedule_id, action, ...) - 일정 업데이트, 삭제, 일시 중지/재개

스키마 드리프트 (5개 도구)

  • get_schema_summary() - 스키마 드리프트 개요

  • list_schema_changes(asset_id, severity, from_date, to_date) - 감지된 변경 사항 목록

  • create_schema_baseline(asset_id, description) - 기준 생성

  • enable_schema_monitoring(asset_id, schedule_type, notify_on) - 모니터링 활성화

  • disable_schema_monitoring(asset_id) - 모니터링 비활성화

  • get_schema_monitoring(asset_id) - 현재 모니터링 구성 보기

  • dry_run_schema(asset_id, schedule_type) - 활성화 전 스키마 모니터링 테스트

데이터 품질 (4개 도구)

  • get_metrics_summary(asset_id) / list_metrics(asset_id) - 지표 보기

  • create_metric(asset_id, metric_type, table_path, ...) - 행 수, null 비율 또는 사용자 지정 지표 생성

  • manage_metric(metric_id, action, ...) - 업데이트, 삭제, 캡처 또는 스냅샷 보기

  • get_validity_summary(asset_id) / list_validity_rules(asset_id) - 유효성 규칙 보기

  • create_validity_rule(asset_id, rule_type, table_path, ...) - 유효성 규칙 생성

  • manage_validity_rule(rule_id, action, ...) - 업데이트, 삭제, 확인 또는 결과 보기

참조 무결성 (2개 도구)

  • create_referential_check(asset_id, ...) - 테이블 간 참조 확인 생성

  • manage_referential(check_id, action, ...) - 목록, 삭제, 실행 또는 결과 보기

대상 (4개 도구)

  • list_destinations(destination_type) - 알림 대상 목록(Slack, 이메일, 웹훅)

  • setup_destination(destination_type, ...) - Slack 채널, 이메일 또는 웹훅 대상 생성

  • manage_destination(destination_id, action, ...) - 업데이트, 삭제, 테스트, 활성화/비활성화

  • manage_rule_destinations(rule_id, action, ...) - 알림 규칙에 대상 연결/연결 해제

범위 및 권장 사항 (3개 도구)

  • get_coverage(asset_id) - 자산의 범위 계층 및 점수

  • manage_coverage(asset_id, action) - 다음 단계 확인 또는 권장 모니터링 적용

  • recommend(asset_id, recommendation_type) - 신선도, 지표, 범위 또는 임계값에 대한 AI 권장 사항

인텔리전스 (2개 도구)

  • ask_question(asset, question) - 자연어 Q&A

  • generate_intelligence(asset) - AI 지식 베이스 생성 트리거

카탈로그 (4개 도구)

  • get_lineage(asset_id, depth, direction) - 데이터 계보 그래프

  • job_status(job_id) - 비동기 작업 상태 확인

  • create_tag(asset_id, name, object_path, ...) - 태그 생성 및 할당

  • list_tags(asset_id) / apply_tags(asset_id, ...) - 태그 목록 및 적용

API 키

  • get_api_key_info() - 현재 API 키 세부 정보 및 권한 보기

예시

데이터 상태 확인

User: Is my data healthy?

Your data health status:
- Overall: WARNING
- 3 unresolved alerts (1 critical, 2 warning)
- 2 stale tables (orders, customers)
- 1 unacknowledged schema change
- Coverage: 65% (Tier 2: Protected)

AI 권장 사항 받기

User: What should I monitor on my Snowflake warehouse?

Based on your table patterns and update frequency:
1. orders (high traffic) - Add freshness check (hourly), row count metric
2. customers (PII) - Enable schema drift monitoring, add null checks
3. payments (financial) - Add freshness + row count + validity rules

Want me to set these up? I can configure all three in one go.

일일 브리핑

User: What happened overnight?

Your daily briefing:
- 2 new alerts: orders table stale (6h), schema change in users
- Coverage improved: finance schema now at Tier 3 (Verified)
- Recommendation: 4 tables still have no monitoring. Run /armor:recommend.

근본 원인 분석

User: Why is the orders table stale?

Investigation results:
- Last update: 6 hours ago (expected: hourly)
- Upstream dependency: raw_orders was last updated 8 hours ago
- Likely cause: upstream ETL job failed or delayed
- Impact: 3 downstream dashboards affected

문제 해결

인증 실패

Error: No API key configured

해결 방법: ARMOR_API_KEY 환경 변수를 설정하거나 ~/.armor/config.yaml을 생성하세요.

MCP 서버를 찾을 수 없음

Error: MCP server 'armor' not found

해결 방법:

  1. 구성 변경 후 AI 도구를 다시 시작하세요.

  2. uvx가 설치되어 있는지 확인하세요: uvx --version

  3. MCP 구성 구문을 확인하세요.

기술이 로드되지 않음

해결 방법:

  1. 플러그인이 설치되었는지 확인하세요: claude plugin list

  2. 기술 디렉토리가 존재하는지 확인하세요.

  3. Claude Code를 다시 시작하세요.

개발

개발 지침은 AGENTS.md를 참조하세요.

지원

라이선스

MIT 라이선스 - LICENSE 참조

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      Open-source agentic schema layer. Define metrics once in YAML, query governed data from any warehouse (Snowflake, BigQuery, Databricks, PostgreSQL, DuckDB) via MCP.
      28
      Apache 2.0
    • A
      license
      B
      quality
      D
      maintenance
      Agentic data quality MCP server — runs structured validation rules against warehouses (DuckDB, BigQuery, Athena, Databricks, Postgres), diagnoses failures with LLM root cause analysis, and proposes SQL remediations. Full audit trail of every AI decision.
      6
      15 PyPI
      5
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Data Workers is the Autonomous Agentic Data Platform: reduce your data ops to zero, with agents that run the whole data platform (pipelines, quality, incidents, schema change, catalog, governance) through MCP in Claude Code, Codex, Cursor and any MCP client. Learn more at dataworkers.io.
      14
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      AI-driven MCP server that audits, profiles, detects schema drift, and auto-generates documentation for dbt projects, enabling natural language interaction with your dbt project's health.
      103
      MIT