rkttu · March 22, 2026 14:14
diff --git a/README.md b/README.md
diff --git a/app.cs b/app.cs
 #!/usr/bin/env dotnet
 #:sdk Microsoft.NET.Sdk.Web
 #:package Microsoft.Data.Sqlite@9.*
 #:package ModelContextProtocol.AspNetCore@1.*
 #:property PublishAot=false

 using Microsoft.Data.Sqlite;
 using ModelContextProtocol.Server;
 using System.ComponentModel;

 var builder = WebApplication.CreateBuilder(args);

 builder.Services
    .AddMcpServer()
    .WithHttpTransport()
    .WithToolsFromAssembly();

 var app = builder.Build();
 app.MapMcp();
 await app.RunAsync();

 [McpServerToolType]
 public static class ChinookTools
 {
    private const string DbPath = "Chinook_Sqlite.sqlite";

    [McpServerTool, Description("아티스트를 이름으로 검색하고, 해당 아티스트의 앨범 목록을 함께 반환합니다.")]
    public static string SearchArtists(
        [Description("검색할 아티스트 이름 (부분 일치)")] string name)
    {
        using var conn = new SqliteConnection($"Data Source={DbPath}");
        conn.Open();

        using var cmd = conn.CreateCommand();
        cmd.CommandText = """
            SELECT ar.ArtistId, ar.Name, al.Title
            FROM Artist ar
            LEFT JOIN Album al ON ar.ArtistId = al.ArtistId
            WHERE ar.Name LIKE @name
            ORDER BY ar.Name, al.Title
            """;
        cmd.Parameters.AddWithValue("@name", $"%{name}%");

        using var reader = cmd.ExecuteReader();
        var results = new System.Text.StringBuilder();
        while (reader.Read())
        {
            var album = reader.IsDBNull(2) ? "(앨범 없음)" : reader.GetString(2);
            results.AppendLine($"[{reader.GetInt32(0)}] {reader.GetString(1)} — {album}");
        }

        return results.Length > 0 ? results.ToString() : $"'{name}'에 해당하는 아티스트를 찾을 수 없습니다.";
    }

    [McpServerTool, Description("트랙을 이름으로 검색하고, 앨범명, 아티스트명, 장르, 재생 시간을 함께 반환합니다.")]
    public static string SearchTracks(
        [Description("검색할 트랙 이름 (부분 일치)")] string keyword)
    {
        using var conn = new SqliteConnection($"Data Source={DbPath}");
        conn.Open();

        using var cmd = conn.CreateCommand();
        cmd.CommandText = """
            SELECT t.Name, al.Title, ar.Name, g.Name,
                   t.Milliseconds / 1000 / 60 || ':' ||
                   substr('0' || (t.Milliseconds / 1000 % 60), -2) AS Duration
            FROM Track t
            JOIN Album al ON t.AlbumId = al.AlbumId
            JOIN Artist ar ON al.ArtistId = ar.ArtistId
            JOIN Genre g ON t.GenreId = g.GenreId
            WHERE t.Name LIKE @kw
            ORDER BY ar.Name, al.Title
            LIMIT 20
            """;
        cmd.Parameters.AddWithValue("@kw", $"%{keyword}%");

        using var reader = cmd.ExecuteReader();
        var results = new System.Text.StringBuilder();
        while (reader.Read())
        {
            results.AppendLine(
                $"{reader.GetString(0)} [{reader.GetString(4)}] — {reader.GetString(2)} / {reader.GetString(1)} ({reader.GetString(3)})");
        }

        return results.Length > 0 ? results.ToString() : $"'{keyword}'에 해당하는 트랙을 찾을 수 없습니다.";
    }

    [McpServerTool, Description("장르별 트랙 수와 총 재생 시간을 조회합니다. 특정 장르를 지정하면 해당 장르의 트랙 목록을 반환합니다.")]
    public static string GetGenreStats(
        [Description("특정 장르 이름 (생략하면 전체 장르 통계를 반환)")] string? genre = null)
    {
        using var conn = new SqliteConnection($"Data Source={DbPath}");
        conn.Open();

        using var cmd = conn.CreateCommand();

        if (string.IsNullOrWhiteSpace(genre))
        {
            cmd.CommandText = """
                SELECT g.Name, COUNT(*) AS TrackCount,
                       SUM(t.Milliseconds) / 1000 / 3600 || '시간 ' ||
                       (SUM(t.Milliseconds) / 1000 % 3600) / 60 || '분' AS TotalDuration
                FROM Track t
                JOIN Genre g ON t.GenreId = g.GenreId
                GROUP BY g.Name
                ORDER BY TrackCount DESC
                """;
        }
        else
        {
            cmd.CommandText = """
                SELECT t.Name, ar.Name, al.Title,
                       t.Milliseconds / 1000 / 60 || ':' ||
                       substr('0' || (t.Milliseconds / 1000 % 60), -2) AS Duration
                FROM Track t
                JOIN Genre g ON t.GenreId = g.GenreId
                JOIN Album al ON t.AlbumId = al.AlbumId
                JOIN Artist ar ON al.ArtistId = ar.ArtistId
                WHERE g.Name = @genre
                ORDER BY ar.Name, t.Name
                LIMIT 30
                """;
            cmd.Parameters.AddWithValue("@genre", genre);
        }

        using var reader = cmd.ExecuteReader();
        var results = new System.Text.StringBuilder();

        if (string.IsNullOrWhiteSpace(genre))
        {
            while (reader.Read())
                results.AppendLine($"{reader.GetString(0)}: {reader.GetInt32(1)}곡 ({reader.GetString(2)})");
        }
        else
        {
            while (reader.Read())
                results.AppendLine($"{reader.GetString(0)} [{reader.GetString(3)}] — {reader.GetString(1)} / {reader.GetString(2)}");
        }

        return results.Length > 0 ? results.ToString() : $"'{genre}' 장르를 찾을 수 없습니다.";
    }
 }
diff --git a/Caddyfile b/Caddyfile
 {$MCP_DOMAIN} {
 	reverse_proxy mcp-server:8080
 }
diff --git a/cloud-init.sh b/cloud-init.sh
 #!/bin/bash
 curl -fsSL https://get.docker.com | sh
 usermod -aG docker azureuser
diff --git a/docker-compose.yml b/docker-compose.yml
 services:
  mcp-server:
    build:
      context: .
      dockerfile: Dockerfile
    restart: unless-stopped
    expose:
      - "8080"

  caddy:
    image: caddy:2
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy_data:/data
      - caddy_config:/config
    environment:
      - MCP_DOMAIN=${MCP_DOMAIN}
    depends_on:
      - mcp-server

 volumes:
  caddy_data:
  caddy_config:
diff --git a/Dockerfile b/Dockerfile
 FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
 WORKDIR /src
 COPY app.cs .
 RUN dotnet publish app.cs -c Release -o /app

 FROM mcr.microsoft.com/dotnet/aspnet:10.0
 WORKDIR /app
 COPY --from=build /app .
 COPY Chinook_Sqlite.sqlite .
 ENV ASPNETCORE_URLS=http://+:8080
 EXPOSE 8080
 ENTRYPOINT ["./app"]
항목	내용
소요 시간	50분
난이도	초중급
대상	C# 기초 문법을 아는 개발자
목표	Azure VM에 MCP 서버를 배포하고, Microsoft Foundry에서 에이전트를 만들어 MCP 도구를 연결
준비물	Azure 구독, 웹 브라우저 (Azure 포털 접속용)
지시문	역할	예시
`#:package`	NuGet 패키지 참조 추가	`#:package Newtonsoft.Json@13.0.3`
`#:sdk`	사용할 SDK 지정 (기본값: `Microsoft.NET.Sdk`)	`#:sdk Microsoft.NET.Sdk.Web`
`#:property`	MSBuild 속성 설정	`#:property PublishAot=false`
`#:project`	다른 프로젝트 파일 참조	`#:project ../Shared/Shared.csproj`
항목	stdio	HTTP (Streamable HTTP)
통신 방식	표준 입출력 (stdin/stdout)	HTTP 요청/응답
클라이언트 실행	클라이언트가 서버 프로세스를 직접 실행	독립적으로 실행 중인 서버에 네트워크로 연결
배포	로컬 전용, 클라이언트와 같은 머신	원격 서버, 클라우드, 컨테이너 배포 가능
다중 클라이언트	프로세스당 1개 클라이언트	여러 클라이언트가 동시에 접속 가능
필요 SDK	`Microsoft.NET.Sdk`	`Microsoft.NET.Sdk.Web`
패키지	`ModelContextProtocol`	`ModelContextProtocol.AspNetCore`
적합한 용도	개발/테스트, 단일 사용자	프로덕션, 팀 공유, 서비스 배포
옵션	설명
`--image Ubuntu2404`	Ubuntu 24.04 LTS 이미지 사용
`--size Standard_B2s`	2 vCPU, 4 GiB RAM — 핸즈온랩에 충분한 크기
`--generate-ssh-keys`	Cloud Shell에서 SSH 키 자동 생성 및 VM에 등록
`--public-ip-address-dns-name`	VM의 공인 IP에 DNS 레이블 할당 → `<DNS_LABEL>.<LOCATION>.cloudapp.azure.com`
`--custom-data @cloud-init.sh`	파일을 참조하여 VM 최초 부팅 시 cloud-init으로 Docker Engine 자동 설치
도구	설명
`SearchArtists(name)`	아티스트를 이름으로 검색하고 앨범 목록을 반환
`SearchTracks(keyword)`	트랙을 이름으로 검색하고 상세 정보를 반환
`GetGenreStats(genre?)`	장르별 통계 조회, 특정 장르의 트랙 목록 반환
서비스	역할
`mcp-server`	MCP 서버 컨테이너. 내부 포트 8080으로만 노출 (외부 직접 접근 불가)
`caddy`	리버스 프록시 + 자동 HTTPS. 80/443 포트를 외부에 노출
필드	값
Agent name	`chinook-agent`
Model	`gpt-5.2` (방금 배포한 모델)
Instructions	아래 내용 참조
관점	이점
개발 비용	`.cs` 파일 하나로 MCP 서버 완성 — 프로젝트 구조, 빌드 파이프라인 불필요
보안	레거시 DB를 퍼블릭 인터넷에 노출하지 않음 — Tailscale/NetBird로 전 구간 암호화
운영	Docker Compose로 배포 — 기존 인프라 변경 최소화
AI 활용	Foundry 에이전트가 자연어로 레거시 DB를 질의 — SQL 지식 없이도 데이터 접근 가능
기존 방식	파일 기반 앱
`.csproj` + `Program.cs` + NuGet 구성	`.cs` 파일 1개
`dotnet new` → `dotnet add package` → `dotnet run`	`dotnet run app.cs`
프로젝트 단위 빌드	파일 단위 실행
별도 publish 설정 필요	`dotnet publish app.cs`로 바로 배포
구성 요소	역할	코드에서의 위치
Web Host	서버 수명 주기 + HTTP 파이프라인 관리	`WebApplication.CreateBuilder`
Transport	클라이언트와의 통신 방식	`WithHttpTransport()`
Endpoint	HTTP 라우트 매핑	`app.MapMcp()`
Tool Type	도구 메서드를 포함하는 클래스	`[McpServerToolType]` 어트리뷰트
Tool	AI가 호출하는 기능 단위	`[McpServerTool]` 어트리뷰트
Description	AI가 도구의 용도를 이해하기 위한 설명	`[Description]` 어트리뷰트