Azure MCP Server

Azure MCP 서버

Azure 서비스와 상호 작용하기 위한 모델 컨텍스트 프로토콜 서버 구현입니다. 현재 Azure Blob Storage 및 Azure Cosmos DB(NoSQL API)를 지원합니다. 이 서버를 통해 수행되는 모든 작업은 자동으로 기록되며, audit://azure-operations 리소스 엔드포인트를 통해 액세스할 수 있습니다.

Claude Desktop App을 사용하여 로컬로 실행

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Azure MCP 서버를 자동으로 설치하려면 다음을 수행합니다.

지엑스피1

수동 설치

1. 저장소 복제: 이 저장소를 로컬 컴퓨터에 복제합니다.
2. Azure 자격 증명 구성: Azure 자격 증명을 구성하세요. 이 서버에는 Blob Storage, Cosmos DB 및 App Configuration에 대한 적절한 권한이 있는 Azure 계정이 필요합니다. 다양한 방법으로 인증을 시도하는 DefaultAzureCredential 사용하는 것이 좋습니다.
   • 환경 변수: 다음 환경 변수를 설정합니다.
     • AZURE_STORAGE_ACCOUNT_URL : Azure Storage 계정의 URL(예: https://<your_account_name>.blob.core.windows.net ).
     • AZURE_COSMOSDB_ENDPOINT : Azure Cosmos DB 계정의 엔드포인트 URL입니다.
     • AZURE_COSMOSDB_KEY : Azure Cosmos DB 계정의 기본 키 또는 보조 키입니다. 중요: 이 키는 암호처럼 취급하고 안전하게 보관하세요.
     • AZURE_APP_CONFIGURATION_ENDPOINT : Azure 앱 구성 인스턴스의 URL입니다.
   • Azure CLI: 또는 Azure CLI를 사용하여 인증할 수 있습니다. 필요한 권한이 있는 계정으로 로그인했는지 확인하세요. 이 서버는 DefaultAzureCredential 사용하므로 환경 변수가 지정되지 않으면 Azure CLI 자격 증명으로 자동 인증됩니다. az login 사용하여 로그인하세요.
3. Claude Desktop 구성: claude_desktop_config.json 파일에 다음 구성을 추가합니다.
   • macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • 윈도우: %APPDATA%/Claude/claude_desktop_config.json
   "mcpServers": { "mcp-server-azure": { "command": "uv", "args": [ "--directory", "/path/to/repo/azure-mcp-server", "run", "azure-mcp-server" ] } }

   /path/to/repo/azure-mcp-server 복제된 저장소의 실제 경로로 바꿉니다.

4. Claude Desktop 설치 및 실행: Claude 데스크톱 앱을 설치하고 엽니다.
5. 설정 테스트: Claude에게 Azure 도구를 사용하여 읽기 또는 쓰기 작업을 수행하도록 요청합니다(예: Blob Storage 컨테이너 생성 또는 Cosmos DB에 항목 추가). 문제가 발생하면 여기에서 MCP 디버깅 설명서를 참조하세요.

사용 가능한 도구

Azure Blob 저장소 작업

• blob_container_create: 새 Blob Storage 컨테이너를 생성합니다. container_name 이 필요합니다.
• blob_container_list: 구성된 계정에 있는 모든 Blob Storage 컨테이너를 나열합니다.
• blob_container_delete: Blob Storage 컨테이너를 삭제합니다. container_name 이 필요합니다.
• blob_upload: Blob Storage 컨테이너에 blob(파일)을 업로드합니다. container_name , blob_name , file_content (Base64 인코딩)가 필요합니다.
• blob_delete: Blob Storage 컨테이너에서 blob을 삭제합니다. container_name 과 blob_name 필요합니다.
• blob_list: Blob Storage 컨테이너 내의 Blob을 나열합니다. container_name 이 필요합니다.
• blob_read: Blob Storage에서 blob의 내용을 읽습니다. container_name 과 blob_name 필요합니다. 내용을 텍스트로 반환합니다.

Azure Cosmos DB(NoSQL API) 작업

컨테이너 운영

• cosmosdb_container_create: 데이터베이스 내에 새로운 Cosmos DB 컨테이너를 생성합니다. container_name 과 partition_key 필요합니다. database_name 은 선택 사항이며 기본값은 defaultdb 입니다. partition_key 는 파티션 키를 정의하는 JSON 객체여야 합니다(예: {"paths": ["/myPartitionKey"], "kind": "Hash"} ).
• cosmosdb_container_describe: Cosmos DB 컨테이너에 대한 세부 정보를 검색합니다. container_name 이 필요합니다. database_name 선택 사항이며 기본값은 defaultdb 입니다.
• cosmosdb_container_list: 데이터베이스 내 모든 Cosmos DB 컨테이너를 나열합니다. database_name 은 선택 사항이며 기본값은 defaultdb 입니다.
• cosmosdb_container_delete: Cosmos DB 컨테이너를 삭제합니다. container_name 이 필요합니다. database_name 선택 사항이며 기본값은 defaultdb 입니다.

품목 작업

• cosmosdb_item_create: Cosmos DB 컨테이너 내에 새 항목을 생성합니다. container_name 과 item (항목을 나타내는 JSON 객체)이 필요합니다. database_name 은 선택 사항이며 기본값은 defaultdb 입니다. item 에 파티션 키 필드와 값이 포함되어 있는지 확인하세요.
• cosmosdb_item_read: Cosmos DB 컨테이너에서 항목을 읽습니다. container_name , item_id , partition_key 필요합니다. database_name 선택 사항이며 기본값은 defaultdb 입니다. partition_key 는 읽을 항목의 파티션 키 값과 일치 해야 합니다 .
• cosmosdb_item_replace: Cosmos DB 컨테이너 내의 기존 항목을 교체합니다. container_name , item_id , partition_key , 그리고 item (업데이트된 전체 항목을 나타내는 JSON 객체)이 필요합니다. database_name 은 선택 사항이며 기본값은 defaultdb 입니다. partition_key 는 교체되는 항목의 파티션 키 값과 일치 해야 합니다 .
• cosmosdb_item_delete: Cosmos DB 컨테이너에서 항목을 삭제합니다. container_name , item_id , partition_key 필요합니다. database_name 선택 사항이며 기본값은 defaultdb 입니다. partition_key 는 삭제되는 항목의 파티션 키 값과 일치 해야 합니다 .
• cosmosdb_item_query: SQL 쿼리를 사용하여 Cosmos DB 컨테이너의 항목을 쿼리합니다. container_name 과 query 필요합니다. database_name 선택 사항이며 기본값은 defaultdb 입니다. 매개변수화된 쿼리의 경우, parameters 배열을 선택적으로 사용할 수 있습니다.

Azure 앱 구성 작업

• app_configuration_kv_read: Azure App Configuration에서 키-값을 읽습니다. key 매개 변수는 선택 사항이며 키 패턴으로 필터링할 수 있습니다(와일드카드 지원, 예: 'app1/ '). label 매개 변수는 레이블 값으로 필터링할 때 선택 사항입니다(레이블 없음은 '\0', 레이블 있음은 ' ').
• app_configuration_kv_write: Azure App Configuration에서 키-값을 쓰거나 업데이트합니다. key 및 value 매개 변수가 필요합니다. 선택적 매개 변수로는 키-값에 레이블을 적용하는 label 과 콘텐츠 유형(예: 'application/json')을 지정하는 content_type 있습니다.
• app_configuration_kv_delete: Azure App Configuration에서 키-값을 삭제합니다. key 매개 변수가 필요합니다. label 매개 변수는 선택 사항이며, 삭제할 레이블이 지정된 키 버전을 지정합니다.

중요한 Cosmos DB 참고 사항:

• 파티션 키: Cosmos DB는 효율적인 데이터 저장 및 검색을 위해 파티션 키를 필요로 합니다. 컨테이너를 생성할 때 파티션 키를 정의 해야 합니다 . 항목을 읽거나, 바꾸거나, 삭제할 때는 액세스하는 항목에 대한 올바른 파티션 키 값을 제공 해야 합니다 . 파티션 키는 데이터 내의 속성입니다.
• 대소문자 구분: Cosmos DB 리소스 이름(데이터베이스, 컨테이너, 항목 ID)과 파티션 키 값은 대소문자를 구분합니다. 도구 호출 시 대소문자를 정확하게 사용해야 합니다.
• 기본 데이터베이스: database_name 지정하지 않으면 서버는 기본적으로 SampleDB 라는 데이터베이스를 사용합니다. 이 데이터베이스가 있는지 확인하거나 도구 호출 인수에 원하는 데이터베이스 이름을 명시적으로 제공하세요.

이 README는 Claude 데스크톱 애플리케이션과 함께 Azure MCP 서버를 설정하고 사용하는 데 필요한 정보를 제공합니다. Azure 자격 증명을 안전하게 관리하고 프로토콜에 대한 자세한 내용은 MCP 설명서를 참조하십시오.