DCI MCP Server

This project provides a Model Context Protocol (MCP) server adapted for the DCI API. It allows AI models to interact with DCI for comprehensive data extraction about DCI jobs, components, topics and files.

Features

• 🚀 FastAPI: Built on a modern, fast web framework
• 🤖 MCP: Implements the Model Context Protocol for AI integration
• 🔍 Comprehensive DCI API: Full access to DCI components, jobs, files, pipelines, products, teams, and topics
• 🔧 Smart PR Detection: Advanced PR build finder that analyzes job URLs and metadata
• 🔐 DCI Integration: Native DCI API support with authentication
• 📝 Easy Configuration: Support for .env files for simple setup
• ✅ Code Quality: Comprehensive pre-commit checks and linting
• 📊 Google Drive Integration: Convert DCI reports to Google Docs with rich formatting
• 🎫 Jira Integration: Collect comprehensive ticket data from Jira with comments and changelog
• 🐙 GitHub Integration: Search issues and pull requests using GitHub’s powerful search API
• 🔴 Red Hat Support Case Integration: Access Red Hat support case data from the Customer Portal

Installation

# Clone the repository
git clone https://github.com/redhat-community-ai-tools/dci-mcp-server
cd dci-mcp-server

# Install dependencies
uv sync

# Activate virtual environment
source .venv/bin/activate

Configuration

The server supports multiple ways to configure DCI authentication:

Copy the example file and customize it:

cp env.example .env
# Edit .env with your DCI credentials

Example .env file:

# Method 1: API Key Authentication
DCI_CLIENT_ID=/
DCI_API_SECRET=

# Method 2: User ID/Password (alternative to API key)
# DCI_LOGIN=foo
# DCI_PASSWORD=bar

# Google Drive Integration (optional)
# GOOGLE_CREDENTIALS_PATH=credentials.json
# GOOGLE_TOKEN_PATH=token.json

MCP Configuration

Cursor IDE (stdio transport)

Add to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "dci": {
      "command": "uv",
      "args": ["run", "/path/to/dci-mcp-server/.venv/bin/python", "/path/to/dci-mcp-server/main.py"],
      "description": "MCP server for DCI integration"
    }
  }
}

Claude Desktop (~/.claude.json)

{
  "mcpServers": {
    "dci": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/dci-mcp-server", "main.py"],
      "env": {
        "DCI_CLIENT_ID": "your-client-id",
        "DCI_API_SECRET": "your-secret",
        "DCI_CS_URL": "https://api.distributed-ci.io"
      }
    }
  }
}

Claude CLI (~/.claude.json)

• close the claude cli
• include the block above in the ~/.claude.json file
• start a claude session from the /path/to/dci-mcp-server/ directory
• verify MCP is connected with /mcp

Web-based Integration (SSE transport)