Skip to content

🛡️ Sentinel CI

Universal CI/CD Intelligence for AI Agents

Python MCP License CI Status Docs PRs Welcome
Get Started View on GitHub

What is Sentinel CI?

Sentinel CI is a multi-platform CI/CD intelligence layer built using the Model Context Protocol (MCP). It provides a unified interface for AI agents like Claude to interact with various CI/CD platforms.

Supported Platforms

  • :material-jenkins: Jenkins

    Classic & Pipeline jobs, Blue Ocean, JUnit tests

    Learn more

  • GitHub Actions

    Workflow runs, job details, artifacts

    Learn more

  • GitLab CI

    Pipelines, stages, native test reports

    Learn more

Key Features

🎯 Multi-Platform Support

Connect to Jenkins, GitHub Actions, and GitLab CI through a single unified interface.

🚀 8 Powerful MCP Tools

  • health_check() - Verify platform connectivity
  • list_jobs() - List all jobs/workflows
  • get_build_summary() - Get build overview
  • get_failed_stages() - Identify failed stages
  • get_failed_tests() - Get failed test details
  • get_log_excerpt() - Extract relevant logs
  • get_metrics() - System performance metrics
  • clear_cache() - Cache management

🔒 Security First

  • Read-only operations - Cannot trigger builds or modify configs
  • Secret redaction - 12 patterns for automatic sanitization
  • Environment variables - No hardcoded credentials
  • Audit logging - Track all operations

⚡ Performance

  • Smart caching - TTL-based with LRU eviction (70%+ hit rate)
  • Fast responses - < 2s latency (P95)
  • Prometheus metrics - Monitor everything
  • Thread-safe - Concurrent request handling

Quick Example

from sentinel_ci import SentinelCI

# Initialize
sentinel = SentinelCI(platform="jenkins")

# Check health
status = sentinel.health_check()

# List jobs
jobs = sentinel.list_jobs()

# Get failed tests
tests = sentinel.get_failed_tests(
    job="backend-service",
    build_id="42"
)

Architecture

graph TB
    A[AI Agent] --> B[MCP Server]
    B --> C{Platform Router}
    C --> D[Jenkins Client]
    C --> E[GitHub Client]
    C --> F[GitLab Client]
    D --> G[Jenkins API]
    E --> H[GitHub API]
    F --> I[GitLab API]

    B --> J[Shared Components]
    J --> K[Cache]
    J --> L[Redactor]
    J --> M[Metrics]

Why Sentinel CI?

For AI Agents

  • Unified interface across all CI platforms
  • Contextual information for better debugging
  • Safe operations - read-only by design
  • Reliable caching for fast responses

For Developers

  • Easy integration with Claude Desktop
  • Extensible architecture - add your own platforms
  • Well documented - comprehensive guides
  • Open source - MIT licensed

For Teams

  • Multi-platform support - use your existing tools
  • Security focused - enterprise-ready
  • Performance optimized - handles scale
  • Community driven - active development

Getting Started

Ready to integrate Sentinel CI with your workflow?

Community

Contribute to Sentinel CI:

License

Sentinel CI is open source software licensed as MIT.