MCP Repository - GitHub Actions Calculator

📋 Project Overview

This repository demonstrates the creation and implementation of a GitHub Actions CI/CD workflow using the GitHub MCP (Model Context Protocol) Server. The project showcases automated workflow creation, configuration, and execution through AI-assisted development.

🎯 Project Objectives

• Create a GitHub Actions workflow with manual trigger capabilities
• Implement user input collection through workflow_dispatch event
• Perform automated calculations and display results
• Demonstrate MCP server integration for repository management

🛠️ What We Built

GitHub Actions Workflow: Add Two Numbers Calculator

File Location: .github/workflows/add-numbers.yml

Workflow Features:

• ✅ Manual Trigger: Uses workflow_dispatch for on-demand execution
• ✅ User Input Collection: Prompts for two numbers when triggered
• ✅ Automated Calculation: Adds the input numbers together
• ✅ Multi-format Output: Console logs and formatted summary
• ✅ Professional UI: Clean results display in GitHub Actions interface

🚀 How to Use the Workflow

Step-by-Step Instructions:

1. Navigate to Actions

   • Go to the repository: https://github.com/bikram-singh/MCP
   • Click on the Actions tab

2. Select the Workflow

   • Find “Add Two Numbers Calculator” in the workflow list
   • Click on the workflow name

3. Run the Workflow

   • Click the “Run workflow” button
   • Enter your desired numbers in the input fields:
     • First Number: Enter any numeric value
     • Second Number: Enter any numeric value
   • Click “Run workflow” to execute

4. View Results

   • Monitor the workflow execution in real-time
   • Check the detailed logs for step-by-step output
   • View the formatted summary with calculation results

🔧 Technical Implementation

Workflow Configuration

name: Add Two Numbers Calculator

on:
  workflow_dispatch:
    inputs:
      first_number:
        description: 'Enter the first number'
        required: true
        type: number
        default: '0'
      second_number:
        description: 'Enter the second number'
        required: true
        type: number
        default: '0'

Key Workflow Steps

1. Repository Checkout: Uses actions/checkout@v4
2. Input Display: Shows the user-provided numbers
3. Calculation Logic: Performs addition using shell arithmetic
4. Result Formatting: Creates professional output displays
5. Summary Generation: Builds markdown summary for GitHub UI

🤖 MCP Server Integration

This project was created using the GitHub MCP Server, which enabled:

Automated Repository Operations

• Repository Creation: Programmatic creation of the MCP repository
• File Management: Automated creation of workflow files
• Content Generation: AI-assisted workflow configuration
• Documentation: Automated README generation