Azure MCP Server

🌟 Azure MCP 서버

Azure MCP 서버는 AI 에이전트와 Azure Storage, Cosmos DB 등의 주요 Azure 서비스 간에 원활한 연결을 구축하기 위해 MCP 사양을 구현합니다.

이 프로젝트는 아직 공개 미리보기 단계에 있으며, 일반 공개 전에 구현 방식이 상당히 변경될 수 있습니다.

📑 목차

1. 🎯 개요
2. 🛠️ 현재 지원되는 도구
3. 🔌 설치 및 시작하기
4. 🧪 Azure MCP 서버 사용
5. 📝 문제 해결
6. 👥 Azure MCP 서버에 기여

🎯 개요

✨ Azure MCP 서버로 무엇을 할 수 있나요?

Azure MCP 서버는 Azure 컨텍스트를 통해 에이전트의 역량을 강화합니다. 다음은 시도해 볼 만한 몇 가지 멋진 프롬프트입니다.

🔍 Azure 리소스 탐색

• "내 Azure 저장소 계정 나열"
• "내 모든 Cosmos DB 데이터베이스를 보여주세요"
• "Azure AI Search 서비스 'mysvc'에는 어떤 인덱스가 있나요?"
• "내 리소스 그룹 나열"
• "내 저장소 계정의 테이블을 보여주세요"
• "Cosmos DB 데이터베이스에 있는 컨테이너 나열"
• "내 스토리지 컨테이너에 대한 세부 정보 가져오기"
• "클러스터 'mycluster'에서 Kusto 데이터베이스 가져오기"
• "Kusto 데이터베이스 'db1'의 'StormEvents' 테이블에서 10개 행 샘플"

📊 쿼리 및 분석

• "내 Log Analytics 작업 공간 쿼리"
• "이 인덱스에서 '내 검색어'를 검색해 보겠습니다."

⚙️ 구성 관리

• "내 앱 구성 저장소 나열"
• "앱 구성에서 키-값 쌍 표시"

🔧 고급 Azure 작업

• "Azure CDN 엔드포인트 나열"
• "Node.js를 사용하여 Azure 애플리케이션을 빌드하는 데 도움을 주세요"

🔍 작동 원리

Azure MCP 서버는 다음을 통해 AI 에이전트와 Azure 서비스 간의 원활한 통합을 구축합니다.

• 🔄 AI 에이전트가 이해하는 스마트 JSON 통신
• 🏗️ Azure 작업으로 번역되는 자연어 명령
• 💡 지능형 매개변수 제안 및 자동 완성
• ⚡ 의미 있는 일관된 오류 처리

🛠️ 현재 지원되는 도구

Azure MCP 서버는 다음 Azure 서비스와 상호 작용하기 위한 도구를 제공합니다.

🔎 Azure AI Search(검색 엔진/벡터 데이터베이스)

• Azure AI Search 서비스 나열
• 인덱스를 나열하고 스키마와 구성을 살펴보세요.
• 쿼리 검색 인덱스

📊 Azure Cosmos DB(NoSQL 데이터베이스)

• Cosmos DB 계정 나열
• 데이터베이스 목록 및 쿼리
• 컨테이너 및 항목 관리
• 컨테이너에 대해 SQL 쿼리 실행

🐘 PostgreSQL용 Azure 데이터베이스 - 유연한 서버

• 데이터베이스를 나열하고 쿼리합니다.
• 테이블에 대한 스키마를 나열하고 가져옵니다.
• 서버에 대한 목록을 작성하고, 구성을 가져오고, 매개변수를 가져옵니다.

🧮 Kusto(Azure Data Explorer)

• Kusto 클러스터 나열
• Kusto 클러스터의 데이터베이스 나열
• Kusto 데이터베이스의 테이블 나열
• Kusto 테이블에 대한 스키마 가져오기
• Kusto 테이블의 샘플 행
• KQL을 사용하여 Kusto 데이터베이스 쿼리

💾 Azure 저장소

• 저장소 계정 목록
• Blob 컨테이너 및 Blob 관리
• 저장소 테이블 목록 및 쿼리
• 컨테이너 속성 및 메타데이터 가져오기

📈 Azure Monitor(로그 분석)

• Log Analytics 작업 영역 나열
• KQL을 사용하여 로그 쿼리
• 사용 가능한 테이블 나열

⚙️ Azure 앱 구성

• 앱 구성 저장소 나열
• 키-값 쌍 관리
• 라벨이 지정된 구성 처리
• 잠금/잠금 해제 구성 설정

🔑 Azure 키 보관함

• 키 나열, 생성 및 가져오기

📦 Azure 리소스 그룹

• 리소스 그룹 나열

🚌 Azure 서비스 버스

• 큐, 토픽 및 구독에 대한 속성 및 런타임 정보를 조사합니다.

🔧 Azure CLI 확장

• Azure CLI 명령을 직접 실행
• 모든 Azure CLI 기능 지원
• JSON 출력 형식
• 크로스 플랫폼 호환성

🚀 Azure 개발자 CLI(azd) 확장

• Azure Developer CLI 명령을 직접 실행
• 템플릿 검색, 템플릿 초기화, 프로비저닝 및 배포 지원
• 크로스 플랫폼 호환성

에이전트와 모델은 azd MCP 도구의 모범 사례와 사용 지침을 확인하고 학습할 수 있습니다. 자세한 내용은 AZD 모범 사례를 참조하세요.

🛡️ Azure 모범 사례

• 효과적인 코드 생성을 위한 안전하고 프로덕션 수준의 Azure SDK 모범 사례를 알아보세요.

자세한 명령 설명서와 예제는 Azure MCP 명령을 참조하세요.

🔌 시작하기

Azure MCP 서버를 설치하고 실행하려면 Node.js가 필요합니다. 아직 설치하지 않은 경우 여기의 지침을 따르세요.

VS 코드 + GitHub Copilot

Azure MCP Server는 Azure SDK 및 Azure CLI 개발자 도구를 제공합니다. 단독으로 사용하거나 VS Code에서 GitHub Copilot for Azure 확장 프로그램 과 함께 사용할 수 있습니다. Microsoft Learn에서 문서 검색과 같이 Azure MCP Server에 포함되지 않은 다양한 Azure 개발 시나리오에 대한 광범위한 개발자 지원에 관심이 있는 경우에도 이 확장 프로그램을 사용하는 것이 좋습니다.

필수 조건

1. VS Code의 안정 버전이나 Insiders 릴리스를 설치하세요.
   • 💫 안정적인 출시
   • 🔮 인사이더 릴리스
2. GitHub Copilot 및 GitHub Copilot Chat 확장 프로그램 설치
3. Node.js 20 이상을 설치하세요
   • node 와 npm 경로에 있는지 확인하세요.
4. 빈 폴더에서 VS Code를 엽니다.

설치

✨ 원클릭 설치

VS Code 또는 VS Code Insiders용 Azure MCP 서버를 설치하려면 이 버튼 중 하나를 클릭하세요.

Azure MCP 서버를 설치한 후 GitHub Copilot 에이전트 모드를 선택하고 도구 목록을 새로 고치세요. 에이전트 모드에 대한 자세한 내용은 VS Code 설명서를 참조하세요.

🔧 수동 설치

단계별 설치 방법은 다음 지침을 따르세요.

1. .vscode/mcp.json 추가합니다.

지엑스피1

도커 설치

단계별 설치 방법은 다음 지침을 따르세요.

1. 복제 저장소
2. 저장소 루트에서 Docker 이미지를 빌드합니다: docker build -t azure/azuremcp .
3. EnvironmentCredential 세트 중 하나와 일치하는 환경 변수를 사용하여 .env 파일을 만듭니다. 예를 들어, 서비스 주체를 사용하는 .env 파일은 다음과 같습니다.

1. .vscode/mcp.json 추가하거나 기존 MCP 구성을 업데이트하세요. /full/path/to/.env``.env 파일 경로로 바꾸세요.

선택적으로 고객은 --env 또는 --volume 사용하여 인증 값을 전달할 수 있습니다.

🧪 Azure MCP 서버 테스트

1. VS Code에서 GitHub Copilot을 열고 에이전트 모드로 전환합니다.
2. 도구 목록에 Azure MCP 서버가 표시되어야 합니다.
3. "내 Azure Storage 컨테이너 나열"과 같이 에이전트에게 Azure MCP 서버를 사용하도록 알려주는 프롬프트를 시도해 보세요.
4. 에이전트는 Azure MCP 서버 도구를 사용하여 쿼리를 완료할 수 있어야 합니다.

🤖 맞춤형 MCP 클라이언트

MCP 클라이언트가 Azure MCP 서버를 사용하도록 쉽게 구성할 수 있습니다. 클라이언트에서 다음 명령을 실행하고 표준 IO 또는 SSE를 통해 액세스하도록 하세요.

표준 IO 사용

MCP 클라이언트를 구성하여 다음을 실행합니다: npx -y @azure/mcp@latest server start . VS Code 사용 방법은 원클릭 설치 또는 수동 설치의 지침을 따르세요.

SSE 사용

1. 터미널 창을 열고 다음을 실행합니다: npx -y @azure/mcp@latest server start --transport sse
2. 서버가 시작되고 http://localhost:5008 에 호스팅됩니다. 다른 포트를 사용하려면 --port {YOUR-PORT-NUMBER} 추가하세요.
3. MCP 클라이언트를 열고 SSE 구성 값을 추가하세요. 이 설정은 MCP 클라이언트마다 다를 수 있습니다. VS Code에서는 다음과 같습니다.
   { "servers": { "Azure MCP Server": { "type": "sse", "url": "http://localhost:5008/sse" } } }

더 많은 엔드투엔드 MCP 클라이언트/에이전트 가이드가 곧 출시될 예정입니다!

📝 문제 해결

일반적인 문제 및 로깅에 대한 도움말은 문제 해결 가이드를 참조하세요.

🔑 인증

Azure MCP 서버는 호스트 운영 체제의 인증 메커니즘과 완벽하게 통합되어 매우 쉽게 시작할 수 있습니다! Azure Identity는 DefaultAzureCredential 통해 내부적으로 사용되며, 다음과 같은 자격 증명을 시도합니다.

1. 환경 변수 ( EnvironmentCredential ) - CI/CD 파이프라인에 적합
2. 공유 토큰 캐시 ( SharedTokenCacheCredential ) - 다른 도구에서 캐시된 토큰을 사용합니다.
3. Visual Studio ( VisualStudioCredential ) - Visual Studio 자격 증명을 사용합니다.
4. Azure CLI ( AzureCliCredential ) - 기존 Azure CLI 로그인을 사용합니다.
5. Azure PowerShell ( AzurePowerShellCredential ) - Az PowerShell 로그인을 사용합니다.
6. Azure Developer CLI ( AzureDeveloperCliCredential ) - azd 로그인을 사용합니다.
7. 대화형 브라우저 ( InteractiveBrowserCredential ) - 필요한 경우 브라우저 기반 로그인으로 돌아갑니다.

이미 이러한 방법 중 하나를 통해 로그인한 경우 Azure MCP 서버는 해당 자격 증명을 자동으로 사용합니다. RBAC(역할 기반 액세스 제어)를 통해 Azure에서 올바른 권한 부여 권한(예: 저장소 계정에 대한 읽기 권한)을 가지고 있는지 확인하세요. Azure의 RBAC 권한 부여 시스템에 대해 자세히 알아보려면 이 링크를 방문하세요.

인증에 문제가 발생하는 경우 문제 해결 가이드를 참조하세요.

프로덕션 자격 증명

기본적으로 Azure MCP 서버는 관리 ID 및 워크로드 ID와 같은 프로덕션 자격 증명을 제외합니다. 이러한 자격 증명을 활성화하려면 환경 변수를 설정하세요.

이 기능은 관리형 ID를 사용하려는 Azure 서비스에서 실행할 때 유용합니다.

🛡️ 보안 참고 사항

귀하의 자격 증명은 항상 공식 Azure Identity SDK를 통해 안전하게 처리됩니다. 당사는 토큰을 직접 저장하거나 관리하지 않습니다 .

MCP는 매우 새롭고 최첨단의 현상입니다. 모든 새로운 기술 표준과 마찬가지로, MCP 서버와 통합되는 모든 시스템이 시스템이 준수해야 하는 모든 규정과 표준을 준수하는지 확인하기 위해 보안 검토를 수행하는 것이 좋습니다. 여기에는 Azure MCP 서버뿐만 아니라 구현하기로 선택한 모든 MCP 클라이언트/에이전트, 그리고 모델 공급자까지 포함됩니다.

👥 기여하기

Azure MCP 서버에 대한 기여를 환영합니다! 버그 수정, 새로운 기능 추가, 문서 개선 등 어떤 기여든 환영합니다.

다음 사항에 대한 지침은 기여 가이드를 읽어보세요.

• 🛠️ 개발 환경 설정
• ✨ 새로운 명령 추가
• 📝 코드 스타일 및 테스트 요구 사항
• 🔄 풀 리퀘스트 만들기

🤝 행동 강령

이 프로젝트는 Microsoft 오픈 소스 행동 강령을 채택했습니다. 자세한 내용은 행동 강령 FAQ를 참조하시거나, 추가 질문이나 의견이 있으시면 opencode@microsoft.com으로 문의해 주세요.