Skip to content

Conversation

Copy link

Copilot AI commented Aug 25, 2025

This PR enhances the discoverability and usability of the AKS Model Context Protocol (MCP) Server feature by adding comprehensive documentation and integration tools to help users get started with AI-powered AKS operations.

Background

The AKS-MCP Server has already been implemented and is available in public preview at Azure/aks-mcp, providing a secure bridge between AI assistants (GitHub Copilot, Claude, Cursor) and AKS clusters. However, the feature lacked visibility and easy-to-follow setup guidance within the main AKS repository.

Changes Made

Enhanced Main README

  • Added new "AI-Powered AKS Tools" section highlighting the AKS-MCP Server
  • Provides direct links to the repository, blog announcement, and key features

Comprehensive Integration Guide

Created examples/aks-mcp-integration/README.md with:

  • Quick Start Options: Both VS Code extension and manual installation paths
  • AI Assistant Examples: Practical prompts for GitHub Copilot, Claude, and Cursor
  • Use Cases: Real-world scenarios including diagnostics, optimization, security analysis
  • Security Considerations: Multi-tier access control and RBAC compliance details
  • Troubleshooting Guide: Common issues and debug commands

User-Friendly Setup Tools

  • sample-mcp-config.json: Template MCP configuration file with common settings
  • setup.sh: Automated installation script that detects platform, downloads binaries, and creates configuration
  • aks_mcp_issue.md: Dedicated GitHub issue template for AKS-MCP related support requests

Key Features Documented

The AKS-MCP Server enables:

  • Real-time cluster context for AI assistants
  • Secure authentication using Azure CLI credentials and RBAC
  • Natural language operations like "Scale my deployment to 5 replicas"
  • Intelligent diagnostics with root cause analysis
  • Multi-platform support (Windows, macOS, Linux)

Example Usage

Users can now ask AI assistants contextual questions like:

@copilot How is the health of my AKS cluster?
Analyze my cluster's network configuration and identify potential connectivity issues

The MCP server provides real-time cluster data, enabling AI assistants to give accurate, context-aware responses and recommendations.

Impact

This documentation makes the existing AKS-MCP Server feature more discoverable and accessible, helping users leverage AI-powered cluster operations without needing to find the separate repository or figure out configuration details independently.

Fixes #5233.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copy link
Author

Copilot AI commented Aug 25, 2025

@pavneeta 👋 This repository doesn't have Copilot instructions. With Copilot instructions, I can understand the repository better, work faster and produce higher quality PRs.

I can generate a .github/copilot-instructions.md file for you automatically. Click here to open a pre-filled issue and assign it to me. I'll write the instructions, and then tag you for review.

Co-authored-by: pavneeta <51172702+pavneeta@users.noreply.github.com>
Copilot AI changed the title [WIP] Feature Request: AKS Model Context Protocol (MCP) Server Add AKS-MCP Server documentation and integration resources Aug 25, 2025
Copilot AI requested a review from pavneeta August 25, 2025 15:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Feature Request: AKS Model Context Protocol (MCP) Server

2 participants