Azure 리소스 MCP 서버

이 MCP 서버는 모든 MCP 클라이언트에서 직접 Azure 리소스를 나열하고 쿼리할 수 있는 도구를 제공하므로 워크플로를 벗어나지 않고도 Azure 인프라를 효율적으로 탐색하고 비용을 분석할 수 있습니다.

Azure 리소스를 쿼리하는 방법의 예는 다음과 같습니다.

Azure 비용을 쿼리하는 방법의 예는 다음과 같습니다.

특징

• 📊 리소스 검색 - Azure 구독 전반의 모든 리소스를 나열합니다.

• 🔍 필터링 - 리소스 그룹 이름으로 리소스 필터링

• 💰 비용 분석 - Azure 구독에 대한 비용 정보 검색

• 🔐 보안 - Azure 서비스 주체 자격 증명을 사용합니다.

• 🏷️ 자세한 보기 - 모든 리소스의 위치, 유형 및 태그를 확인하세요

Related MCP server: Azure FinOps MCP Server

도구

• Azure 리소스 목록

  • 서비스 주체 인증을 사용하여 Azure 리소스 그룹 및 리소스 나열

  • 입력:

    • subscription_id (문자열, 선택 사항): 쿼리할 특정 구독 ID입니다. 지정하지 않으면 환경 변수의 기본 구독을 사용합니다.

    • resource_group_filter (문자열, 선택 사항): 이름으로 리소스 그룹을 필터링합니다(대소문자 구분 없음, 일치 항목 포함).

  • 반환: 위치, 유형, 태그 등의 세부 정보가 포함된 리소스 그룹 및 해당 리소스의 형식화된 마크다운 목록입니다.

• get_azure_costs_rest

  • REST API를 사용하여 Azure 구독에 대한 비용 분석 데이터 가져오기

  • 입력:

    • subscription_id (문자열, 선택 사항): 쿼리할 특정 구독 ID입니다. 지정하지 않으면 환경 변수의 기본 구독을 사용합니다.

    • timeframe (문자열, 선택 사항): 비용 분석 기간입니다. 기본값은 "MonthToDate"입니다.

  • 반환: 일일 비용과 총액을 포함한 비용 분석 데이터가 포함된 형식화된 마크다운입니다.

구성

Azure 설정

1. 인증을 위한 Azure 서비스 주체를 만듭니다.

지엑스피1

2. 서비스 주체에게 적절한 독자 권한을 할당합니다.

3. Azure 구독 ID, 테넌트 ID, 클라이언트 ID 및 클라이언트 비밀번호를 기록하세요.

4. 필요한 환경 변수를 설정하세요

환경 변수

이 서버에는 다음과 같은 환경 변수가 필요합니다.

# Required Azure authentication
AZURE_TENANT_ID=your-tenant-id
AZURE_CLIENT_ID=your-client-id
AZURE_CLIENT_SECRET=your-client-secret
AZURE_SUBSCRIPTION_ID=your-subscription-id

설치

필수 조건

• 파이썬 3.10+

• 적절한 권한이 있는 Azure 구독

• 리소스에 대한 독자 액세스 권한이 있는 서비스 주체

설정

uv를 사용하는 것을 선호하는 경우:

# Setup environment with uv
uv venv
.venv\Scripts\activate  # On Windows
source .venv/bin/activate  # On macOS/Linux

# Install dependencies
uv add mcp[cli] azure-identity python-dotenv azure-mgmt-resource aiohttp

# Run server
uv run -m azure_resource_mcp_server

Claude Desktop과 함께 사용

Claude Desktop과 함께 사용하려면 구성 파일에 다음을 추가하세요.

{
  "mcpServers": {
    "azure-resource": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
        "run",
        "-m",
        "azure_resource_mcp_server"
      ],
      "env": {
        "AZURE_TENANT_ID": "your-tenant-id",
        "AZURE_CLIENT_ID": "your-client-id",
        "AZURE_CLIENT_SECRET": "your-client-secret",
        "AZURE_SUBSCRIPTION_ID": "your-subscription-id"
      }
    }
  }
}