하여름의 괴발개발

MCP Server 만들어보기

dev여름 — Sun, 21 Dec 2025 21:01:09 +0900

MCP를 사용해보고 어언 7개월이 지났는데 그동안 난 발전한게 1도 없다

7개월전의 나는 내 AI활용능력이 폭발적으로 증가할줄 알았지만 전혀 발전하지 않았고 (공부를 안했으니까요..)

대신 성능이 더 뛰어난 제미나이3와 클로드 4.5 Opus, 그리고 GPT 5.2가 나와서 점점 멍청해지는중

ㅋㅋㅋㅋㅋㅋㅋㅋㅋ

매우 늦었지만 지금이라도 따라잡기 위해 MCP를 만드는 법을 배워보자

이번엔 앤트로픽 공식문서를 보고 공부했다.

MCP 기본 구조

위 그림 예시에서 VSCode가 호스트의 역할을 할 수 있다.

VSCode가 MCP 서버와 연결을 생성하면, 런타임에서 MCP서버와 연결을 유지하는 MCP 클라이언트 오브젝트를 인스턴스화 한다.

또한 그림을 보면 MCP Server 종류가 두가지가 있다.

Local : STDIO 전송을 사용하는 동일한 컴퓨터에서만 사용

Remote : 그림에서 공식 센트리 Remote MCP는 센트리 플랫폼에서 돌고, Streamable HTTP 전송을 사용한다.

MCP Host (호스트)

여러 MCP 클라이언트를 조정하고 관리하는 AI 어플리케이션

Claude Desktop, IDE copilot 등

MCP Client

MCP 서버와 연결을 1:1로 유지

호스트가 사용할 수 있도록 MCP 서버로부터 컨텍스트를 가져온다

메시지 직렬화/역직렬화 처라

MCP Server

MCP 클라이언트에게 기능이나 리소스 제공

여기서 더 딥한 개념이 있지만 일단 넘어가고 서버에 대해 좀 더 알아보도록 하자.

MCP Server의 3가지 핵심기능

서버는 표준화된 프로토콜 인터페이스를 통해 AI 애플리케이션에 기능을 제공한다.

~~근데 도대체 표준화된 프로토콜 인터페이스가 뭔데??~~

일반적인 예시로 문서 접근을 위한 파일시스템 서버, 데이터 쿼리를 위한 데이터베이스 서버, 슬랙 기능을 제공하는 Slack 서버, 일정 관리를 위한 구글 캘린더 서버 등이 있을 수 있다.

Resources

AI가 컨텍스트를 이해하는데 필요한 파일, API, 데이터베이스 같은 데이터를 노출한다.

각 리소스는 고유한 URI를 갖고 적절한 처리를 위해 MIME타입을 선언해야 한다.

(MIME 타입이 뭔지 몰라서 찾아봤는데 파일의 종류와 형식을 알려주는 표준 식별자

예를들면 application/json 이나 text/html, image/jpeg 등)

{
  "uriTemplate": "weather://forecast/{city}/{date}",
  "name": "weather-forecast",
  "title": "Weather Forecast",
  "description": "Get weather forecast for any city and date",
  "mimeType": "application/json"
}

뭐 이런식으로 정의를 한다고 한다.

UI 패턴이 필수가 아니라서 텍스트 기반으로도 사용이 가능하고 주로 검색이나 대량선택, 기존 파일 브라우저와 데이터 탐색기 등에 적합하다고 한다.

Tools

AI 모델이 작업을 수행할 수 있도록 한다.

tool을 정의한다는건 유형이 지정된 입력과 출력 작업을 정의하는 것이다.

AI 모델은 컨텍스트에 기반해 어떤 tool 실행을 할지 선택한 뒤, 사용자한테 내가 이걸 쓸테니 승인해달라는 요청을 한다.

아래와 같은 구조를 갖고 있다.

{
  "name": "tool 이름",
  "description": "tool에 대한 설명",
  "inputSchema": {
    "type": "object",
    "properties": {
      "매개변수1": {
        "type": "string",
        "description": "매개변수 설명"
      }
    },
    "required": ["필수 매개변수 목록"]
  }
}

홈페이지 상 예시는 비행기 예약이었는데, 예를 들어 사용자가

"12월 25일에 인천에서 삿포로로 가는 비행기 찾아줘" 라고 명령을 하면

이 tool을 갖고 있는 AI는 이것을 활용한다는..? 그런 개념이다.

근데 이제 이것만 정의해선 제대로 수행을 못할 것이고 실제로 검색할 수 있도록 뭔가 해야겠지

{
  name: "searchFlights",
  description: "Search for available flights",
  inputSchema: {
    type: "object",
    properties: {
      origin: { type: "string", description: "Departure city" },
      destination: { type: "string", description: "Arrival city" },
      date: { type: "string", format: "date", description: "Travel date" }
    },
    required: ["origin", "destination", "date"]
  }
}

Prompt

내가 생각하는 그 프롬프트가 맞는 것 같은데, 시스템에 미리 입력해두는 프롬프트인듯 하다.

MCP 서버를 잘 활용할 수 있도록 방법을 정의해두는 듯..?

- 예상되는 입력값과 상호작용 패턴을 정의한다.

- 명시적 호출이 필요함 : 보통 '/'를 입력했을때 뜨는 명령어들이 프롬프트에 해당한다..

{
  "name": "프롬프트 이름", 
  "title": "프롬프트 제목",
  "description": "프롬프트 설명",
  "arguments": [
    { "name": "매개변수 이름", "type": "string", "required": 필수여부(true/false) },
  ]
}

날씨 어플리케이션 MCP서버 만들기

https://modelcontextprotocol.io/docs/develop/build-server

Build an MCP server - Model Context Protocol

Get started building your own server to use in Claude for Desktop and other clients.

modelcontextprotocol.io

너무 생략을 많이해놔서 한글버전도 참고했다..

https://wikidocs.net/268827

클로드에 연결할 수 있는 서버를 안내해주고 있고, 위의 세가지 요소 중 tool의 구현에만 집중한다.

Context7 MCP 사용해보기 (LLM 할루시네이션 방지)

dev여름 — Sat, 17 May 2025 23:51:05 +0900

개발동생님의 영상을 보고 실습을 해봄

https://youtu.be/TrXBzzsUUY4

LLM의 문제점

마이너한 기술 스택, 최신 모듈 등의 코드 편집을 요청하면 LLM은 과거 자신이 학습한 데이터를 기반으로 할루시네이션이 발동해 헛소리를 함

Context7 이란?

홈페이지 : https://context7.com/

여러가지 라이브러리들에 대해 LLM 친화적인 콘텍스트를 제공, 구식 코드 생성이나 헛소리 하는걸 막음

글 작성하는 시점 기준 11400개의 라이브러리나 지원한다고 되어있다.

Show docs for..에 내가 사용하고자 하는 함수 등을 입력하면 토큰을 기반으로 알맞는 콘텍스트를 제공해준다.

텍스트를 직접 복사해서 프롬프트에 입력하거나, 링크 형태로 물어볼수도 있다.

혹은 MCP를 설치해서 이용할 수도 있다.

Context7 MCP 서버 Claude Desktop에서 사용해보기

영상에선 Cursor를 내장한 Vscode에서 사용한듯 하지만 난 안쓰므로...claude에서 해봄

MCP 서버 : https://github.com/upstash/context7

GitHub - upstash/context7: Context7 MCP Server -- Up-to-date code documentation for LLMs and AI code editors

Context7 MCP Server -- Up-to-date code documentation for LLMs and AI code editors - upstash/context7

github.com

요것만 복붙하면 끝!

{
  "mcpServers": {
    "Context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

Gatling 지원 언어가 원래 java, scala, kotlin 뿐이었는데 2024년에 javascript도 추가되어 이 내용에 대해 질문해보았다.

Context7 MCP 사용한 버전

Gatling이 워낙 쓰는 사람이 적은 프레임워크라 결국 Context7에서 관련 정보를 가져오는건 실패했지만 꽤나 자세하고 환경 설치부터 시뮬레이션 실행까지 공식문서를 잘 참고해 가이드 해줬다. (틀린정보가 있긴 하지만..)

Context7 MCP 사용하지 않은 버전

일단 내용이 MCP를 사용한 것에 비해 엄청 짧다

그리고 Gatling3.0에서는 Javascript를 사용할 수 없다...

Gatling만 갖고는 사용할 수 없고 javascript SDK를 따로 설치해줘야 함

스크립트도 테스트 해본건 아니지만 공식문서랑 엄청 다르게 생겼고 짬뽕된 느낌

그나마 한번 혼내니까 수정한 느낌....인데 그냥 위에서 대답해준건 다 틀렸다고 보면된다.

아무튼 Context7 MCP를 쓰면 이런 할루시네이션을 줄일 수 있다는건 알겠다

근데 업무에서 어떻게 활용해야 할지 잘 모르겠다.

MCP 개념 및 실습

dev여름 — Sat, 17 May 2025 22:24:18 +0900

시민개발자 구씨 님의 영상 보고 공부하고 따라함

MCP란?

Model Context Protocol
Claude AI 개발사 Anthropic 에서 개발 (공식 문서)
AI 모델이 동작 할 때, 적절한 도구가 필요
각 도구마다 사용법이 다르므로 이 도구들과 소통하는 것을 도와줌

server : 다양한 서비스들을 표준화된 서비스로 이용하기 위한 것
- 다양한 서비스들을 host 서비스들에서 이용하고 싶을 때 서버만 설치하면 바로 사용할 수 있다.
- 예를들어 슬랙과 관련된 어플을 만들고자 할 때, MCP가 없다면?
  - 우리가 슬랙 document를 보면서 코딩으로 슬랙 API들을 모두 구현해야 한다.
    - 채널 리스트 가져오기
    - 메시지 보내기
    - 스레드에 답장하기
    - 리액션 추가하기 등…
    - 인증작업 등..시간이 오래걸림
    - 다른 플랫폼에서 활용하려면 그 환경에 맞게 새로 설정을 해줘야 함
  - 하지만 MCP는 그럴 필요가 없음
  - AI 에이전트 제작이 훨씬 쉬워진다

인터넷 뉴스 레포트 3가지 슬랙으로 보내기 실습

위 영상 그대로 따라함

1. 필요한 기능

인터넷 검색
웹페이지 크롤링
슬랙 메시지 전송

2. Claude desktop 설치 & MCP 서버 설치

https://github.com/modelcontextprotocol/servers

GitHub - modelcontextprotocol/servers: Model Context Protocol Servers

Model Context Protocol Servers. Contribute to modelcontextprotocol/servers development by creating an account on GitHub.

github.com

firecrawl : 웹 크롤링
slack : 슬랙 기능 이용

슬랙은 봇 생성 하고 채널 정보도 넣어줘야해서 좀 복잡하긴 하지만 영상보면서 하면 할만하다.

claude_desktop_config.json 편집

저장 후 Claude 앱 실행하면 사용할 수 있는 MCP 목록이 보인다

3. 명령 수행

MCP를 사용하게 되면 팝업창이 뜨면서 허용을 해주면 이 MCP 를 갖고 우리가 원하는 기능을 수행함

4. 결과물

꽤 잘 생성해줌

업무에서 어떤 MCP를 활용할 수 있을까?

MCP의 한계점

무료버전에서는 AI가 받아들일수 있는 context의 양이 적음
- 대부분 MCP 서버가 잘 동작하지 않음
- 여러개의 MCP 서버를 사용하기 어려움
유료 버전도 아주 큰 파일에 대한 작업은 아직 어려움
완전 자동화 불가능
- 매번 권한 허용을 해줘야 함
- 매일 일정 시간에 주기적인 행동X
내가 원하는 기능을 완전히 사용하려면 코딩이 필요함

Scala Trait

dev여름 — Sat, 22 Feb 2025 20:16:12 +0900

trait의 개념 및 주요 특징

객체지향 프로그래밍에서 Interface와 유사한 역할을 한다.

인스턴스화 할 수 없다.

인터페이스와 다르게 메소드와 필드를 포함할 수 있다.

다중상속은 불가능하지만 여러 trait을 섞어서 사용하는 mixin이라는 개념이 존재한다.

생성자를 가질 수 없다(Scala2 버전만 해당. 3버전은 생성자를 가질 수 있으나, 주의해야함 참고문서)

trait 기본 사용법

trait 정의하기

trait Example {
    //추상메소드
    def exampleMethod1(): Int
    
    //구현된 메소드
    def exampleMethod2(): Unit = {
        println("initialized")
    }
    
    //추상 필드
    val immutableField1: String
    var mutableVField1: String
    
    //값이 정해진 변수
    val immutableField2: String = "immutableField2"
    var muntableField2: String = "mutableField2"
    
    //접근제한자
    private def exampleMethod3(): Unit = {
        println("private method can use only in the tarit")
    }
    
    protected def exampleMethod4(): Unit = {
        println("protected method")
    }
}

trait 사용하기 (매우 기본)

trait을 상속받을때는 extends 키워드를 사용한다.

그 다음 사용하는 trait들 부터는 with이라는 키워드를 사용하는데, mixin이 된다고 보면된다.

trait Sound {
    //추상메소드
    def makeSound(): Unit
}
 
trait Fly {
    //구현된 메소드
    def fly(): Unit = println("flying!")
}
 
trait Eat {
    def eat(): Unit = println("eating")
}

//Sound, Fly, Eat의 기능을 모두 갖고 있는 Bird
class Bird extends Sound with Fly with Eat
 
val bird = new Bird
bird.makeSound()  // Chirp Chirp
bird.fly()        // flying!
bird.eat()       // eating

Java와 차이점

1. 구현된 함수 정의

Java는 8버전 이상부터 default 키워드를 이용하면 인터페이스에 구현된 함수를 정의할 수 있다.

interface Animal {
    defualt public void makeSound(String x) {
        System.out.println("Sound : " + x);
    }
}

Scala는 특별한 키워드 없이 정의 가능하다

trait Animal {
    def makeSound(x: String): Unit = {
        println("Sound : " + x)
    }
}

2. protected 접근제한자 사용

Java의 인터페이스에서는 protected 접근제한자를 사용할 수 없지만, 스칼라는 가능하다.

//불가능
interface Animal {
    protected String getName();
}

//가능
trait Animal {
    protected getName(): String
}

3. 필드 지정

Java의 인터페이스에서는 필드를 정의할 수 없지만, 스칼라는 가능하다.

//불가능
interface Animal {
    String name;
}

//가능
trait Animal {
    var name: String
}

4. 키워드 사용

자바는 인터페이스 구현 시 Implements 키워드를 사용하지만

interface A
interface B
interface C
 
class D implements A, B, C

스칼라는 extends와 with을 사용한다.

trait A
trait B
trait C
 
class D extends A with B with C

자바에서는 클래스를 상속할때 extends키워드를 사용하지만 스칼라는 extends 키워드는 클래스와 trait을 구분하지 않는다.

trait의 선형화

C++등 다중상속이 가능한 언어에서는 죽음의 다이아몬드(the Deadly Diamond of Death)문제가 발생할 수 있다.

     A
    / \
   B   C
    \ /
     D

클래스 B,C가 A를 상속받고, 클래스 D가 B,C를 상속받은 상황에서

D가 super.message()를 출력하는 경우 어떤 클래스의 message()를 실행해야 할까?

일반적인 상황이라면 이런 경우 에러가 나며 실행이 불가능하다.

Scala에서는 클래스 다중상속을 막고 있지만 trait의 선형화를 통해 죽음의 다이아몬드 문제를 자연스럽게 해결하고 있다.

trait A {
  def message(): String = "A"
}

trait B extends A {
  override def message(): String = "B -> " + super.message
}

trait C extends A {
  override def message(): String = "C -> " + super.message
}

class D extends B with C {
  override def message(): String = "D -> " + super.message
}

object Main extends App {
  val d = new D
  println(d.message) // 출력 결과: "D -> C -> B -> A"
}

trait에서는 가장 오른쪽에 선언된 trait순서대로 실행되도록 한다.

이 코드의 선형화 순서는

1. D -> 출력, C가 가장 오른쪽에 선언되었으므로 C의 message 메소드가 실행된다.

2. C -> 출력, B가 오른쪽에서 두번째에 선언되었으므로 B의 message 메소드가 실행된다.

3. B -> 출력, A의 message 메소드가 실행된다. A는 B와 C클래스에서 두번 상속받았지만 선형화 과정에서 한번만 호출된다.

추상클래스와 trait

Scala에도 abstract class도 존재하는데, trait과 매우 유사하다는 생각이 들었다.

그럼 둘 중 어떤걸 써야 하는거지? 라는 생각이 들때 좀 찾아보니 이런 답변들이 있었다.

abstract class를 사용할 때

1. Java 코드에서 상속받아야 할때 (많이 혼용하기 때문)

2. Java 컴파일러를 사용해야 할 때

3. 생성자가 필요할때 (Scala 2버전 사용하는 경우)

trait을 사용할 때

1. 한 클래스에서 독립된 여러 행동들을 하는 경우

2. abstract class를 써야 할지 trait을 써야할지 모르겠는 경우, trait을 먼저 써보고 안되면 abstract class로 바꾸면 된다.

[Docker] Volume의 정의, 종류, 터미널에서 사용하는 법

dev여름 — Mon, 3 Feb 2025 08:34:51 +0900

Volume이란?

호스트머신(로컬 머신)의 폴더. 이미지에 존재하지 않고, 도커 컨테이너와 매핑된다.
COPY 명령어와 비슷해 보이지만, copy 명령어는 파일을 복사만 하기 때문에 컨테이너 외부에서는 사용하지 못한다.
volume은 실제로 폴더를 연결하기 때문에 컨테이너 외부/호스트머신에서도 사용이 가능하다.
볼륨을 지정하면, Docker는 우리의 로컬머신 어딘가 경로에 컨테이너의 폴더를 매핑하는데, 그 경로는 우리가 알 수 없다.
Anonymous volume과 Named volume이 있다.

Volume 종류, 예시

예를 들어 고객의 피드백을 받는 웹애플리케이션의 구조가 다음과 같다고 하자.

고객이 어떤 피드백을 입력했을 때 피드백은 텍스트 파일 형태로 feedback이라는 폴더 안에 저장된다.

이 웹 애플리케이션이 돌아가고 있는 컨테이너가 제거되어도 로컬 경로에 파일이 유지되기를 원한다.

현재 Dockerfile은 다음과 같다.

FROM node:14

WORKDIR /app

COPY package.json .

RUN npm install

COPY . .

EXPOSE 80

CMD [ "node", "server.js" ]

우리의 컨테이너 워크디렉토리는 /app에서 시작하고, 우리는 /feedback 폴더에 볼륨을 지정하고 싶으므로 아래와 같이 지정할 수 있다.

Anonymous Volume (익명 볼륨)

익명 볼륨은 우리가 볼륨의 이름을 지정하지 않고, 매핑할 컨테이너의 경로만 지정한다.

docker bulid -t imagename .
docker run -d -p 3000:80 --rm --name containername -v /app/feedback imagename
docker volume ls

DRIVER    VOLUME NAME
local     3f34a5b8ca185ee642bc3a888df76388627a19e9daab84529772ee5e848e3ccb

docker volume ls 명령어를 실행하면, 우리의 로컬머신 어딘가에 있는 볼륨에 대해 알려준다.

그런데 여기서 docker stop 명령어로 컨테이너를 중지(우리는 컨테이너 실행 명령에 —rm 옵션을 넣었기 때문에 컨테이너가 중지되면 삭제까지 한다.)하고 볼륨을 다시 조회해보면, 볼륨이 사라진 것을 확인할 수 있다.

Named Volume (이름 지정 볼륨)

이름 지정 볼륨은 우리가 로컬에 저장될 볼륨의 이름과 함께 매핑할 컨테이너의 경로를 지정한다.

docker run -d -p 3000:80 --rm --name containername -v volumename:/app/feedback imagename
docker volume ls

DRIVER    VOLUME NAME
local     volumename

하지만 이때는 docker stop 명령어로 컨테이너를 중지하고 삭제한 뒤 docker volume ls로 확인해보면 우리가 지정한 볼륨이 그대로 남아있는 것을 확인할 수 있다.

컨테이너 실행 시 —rm 옵션을 사용하지 않는 경우 Anonymous Volume

이 경우, 컨테이너를 멈추고 docker rm 명령어로 컨테이너를 삭제해도 익명 볼륨이 로컬머신에서 사라지지 않는 것을 확인할 수 있다.

이유는 모른다….왜 저에게 이런 시련을 주시나요

docker bulid -t imagename .
docker run -d -p 3000:80 --name containername -v /app/feedback imagename
docker volume ls
DRIVER    VOLUME NAME
local     d6e3626727d191ea87bcd608db7d0b8881709bec6322fa753eb10bbc27de75dc

docker stop containername
docker volume ls
DRIVER    VOLUME NAME
local     d6e3626727d191ea87bcd608db7d0b8881709bec6322fa753eb10bbc27de75dc

docker rm contianername
docker volume ls
DRIVER    VOLUME NAME
local     d6e3626727d191ea87bcd608db7d0b8881709bec6322fa753eb10bbc27de75dc

여하튼 그래서 볼륨이 삭제되지 않기 때문에 명시적으로 지워줘야 한다.

docker volume rm 볼륨이름 혹은 docker volume prune 명령어로 지우면 된다.

docker volume prune
WARNING! This will remove anonymous local volumes not used by at least one container.
Are you sure you want to continue? [y/N] y
Deleted Volumes:
d6e3626727d191ea87bcd608db7d0b8881709bec6322fa753eb10bbc27de75dc

Total reclaimed space: 0B

[Docker] Volume과 Bind Mount의 정의, 필요한 이유

이 글은 Udemy 강의 Docker & Kubernetes: The Practical Guide [2024 Edition]을 수강하며 정리한 내용입니다. Data의 종류불변 & 읽기 전용 데이터소스코드나 운영체제를 포함한 애플리케이션을 docker image로 빌드

dev.hasummer.com

[Docker] Volume과 Bind Mount의 정의, 필요한 이유

dev여름 — Sun, 2 Feb 2025 23:26:58 +0900

이 글은 Udemy 강의 Docker & Kubernetes: The Practical Guide [2024 Edition]을 수강하며 정리한 내용입니다.

Data의 종류

불변 & 읽기 전용 데이터

소스코드나 운영체제를 포함한 애플리케이션을 docker image로 빌드를 하게 되면, 그 이미지는 더이상 편집이 불가하다. 만약 docker image에 포함된 무언가를 변경하고 싶다면, docker image를 새로 빌드 해야한다.

임시 데이터

프로그램이 실행되는 동안 생성된 임시 데이터 (변수 등)으로, 애플리케이션이 종료되면 사라진다. 애플리케이션이 실행되는 동안만 유효하다. 컨테이너가 종료되면 사라진다.

영구 데이터

프로그램이 실행되는 동안 데이터가 생성되고, 영구적으로 저장되어야 하는 데이터. 예를들면 회원가입을 해서 어떤 계정이 생성되면 그 데이터는 DB등에 영구적으로 저장되어야 한다. 컨테이너가 제거되어도 데이터가 사라지면 안된다. 이때 volume의 도움을 받아야 한다.

컨테이너를 멈추고 제거를 하지 않으면 데이터는 컨테이너 안에 남아있다. 재시작 (docker start)하면 데이터가 남아있는 것을 확인할 수 있다.
컨테이너를 제거하면 데이터가 사라진다.
즉 이것은 임시데이터일 뿐이다.
이것을 해결하려면? 데이터 저장이 되어야 한다.

External Data Storage의 종류

컨테이너 내부의 데이터를 컨테이너 바깥에 영구적으로 저장할 수 있는 방법에는 두가지가 있다.

Docker에 의해 관리되는 Volume과, 사용자에 의해 관리되는 Bind Mount가 있다.

(다음에 이어서 계속… 강의 다 보고 이 글에 정리 예정)

[Docker] Image와 Container의 관계, 이미지로 컨테이너 빌드하기

dev여름 — Sun, 15 Sep 2024 23:30:13 +0900

이 글은 Udemy 강의 Docker & Kubernetes: The Practical Guide [2024 Edition]을 수강하며 정리한 내용입니다.

Image vs Container

Container

모든것을 포함하는 작은 패키지 : 웹사이트, node 서버!

어떤 애플리케이션을 구동할 때 필요한 모든것 ⇒ 소프트웨어의 실행 단위

Image

컨테이너를 위한 템플릿/청사진

이미지에는 코드와, 코드를 실행하는데 필요한 도구가 들어있으며 실제 실행은 컨테이너에서 한다.

컨테이너와 이미지의 관계

이미지에는 모든 설치 지침과 코드가 포함되어있다.

⇒ 다른 머신, 다른 서버에서 같은 이미지를 구동시킬 수 있다.

⇒ 즉, 하나의 이미지로 여러 컨테이너를 구동시킬 수 있다.

비유가 적절한건지는 모르겠으나 내가 이해한 바로 다시 비유를 해보자면

이미지는 레시피, 컨테이너는 이 레시피로 만든 요리의 개념인 것 같다.

이미지를 사용해 컨테이너 빌드하기 1 - Docker Hub

도커 이미지는 docker hub에서 필요한 이미지를 찾을수도 있고, 직접 빌드를 할수 있기도 하다.

먼저 docker hub의 node.js 이미지를 사용하고 실행하는 실습부터 진행한다.

node 이미지는 node 어플리케이션 컨테이너를 생성할 수 있도록 하는 이미지이다.

docker run node

run 명령어는 node.js를 위한 이미지(docker hub에 존재하는)를 갖고 컨테이너를 생성하는 명령어이다.

node 이미지가 내 로컬에 없기 때문에 Hub에서 이미지를 내려받고 컨테이너를 빌드한다.

(이미지를 내려받는다고 해서 우리 컴퓨터에 노드가 설치되는게 전혀 아니다. 도커 환경에만 설치됨)

컨테이너 생성이 잘 되었는지 확인해보자.

docker ps

CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES

엉? 아무것도 없네?

docker ps -a

CONTAINER ID   IMAGE     COMMAND                  CREATED              STATUS                          PORTS     NAMES
3d8b3cbcaeb8   node      "docker-entrypoint.s…"   About a minute ago   Exited (0) About a minute ago             thirsty_aryabhata

docker ps -a 는 종료된 컨테이너까지 모두 보여준다. Exited상태인걸 보니 컨테이너가 종료되었다.

현재 실습으로 진행하고 있는 node의 경우 컨테이너 내부에서 실행할 수 있는 interactive shell 이 존재하는데, 위의 docker run 명령은 컨테이너에서 아무런 상호작용을 하지 않고 종료되었다.

컨테이너는 주변 환경과 분리되어 실행되는 특성이 있기 때문에, 애플리케이션에서 뭔가를 하려면 컨테이너 내부에 접속을 해야한다.

이번에는 -it 옵션과 함께 컨테이너를 실행한다. -it옵션은 docker에게 해당 컨테이너에서 interactive session을 실행하겠다는 의미이다.

docker run -it node

Welcome to Node.js v22.8.0.
Type ".help" for more information.
> 7-3
4

노드 애플리케이션이 컨테이너에서 실행되고 있을때 Status가 Running으로 뜨고 있다.

컨테이너 종료를 하려면 ctrl + C를 두번 누른다.

다시 docker ps -a로 컨테이너 확인을 해보면, IMAGE 부분에 같은 node라는 이미지로 컨테이너가 실행되었다가 종료된 것을 확인할 수 있다.

CONTAINER ID   IMAGE     COMMAND                  CREATED          STATUS                      PORTS     NAMES
48f80cff1528   node      "docker-entrypoint.s…"   5 minutes ago    Exited (0) 3 minutes ago              vigorous_davinci
3d8b3cbcaeb8   node      "docker-entrypoint.s…"   18 minutes ago   Exited (0) 18 minutes ago             thirsty_aryabhata

글이 너무 길어져서 <이미지를 사용해 컨테이너 빌드하기 2>는 다음 글에서 정리한다.

[Docker] Container란? 컨테이너의 필요성, VM과 차이

이 글은 Udemy 강의 Docker & Kubernetes: The Practical Guide [2024 Edition]을 수강하며 정리한 내용입니다. Docker란? Container란?Docker란?컨테이너를 만들고 관리하는 기술컨테이너란?소프트웨어의 표준화된 단

dev.hasummer.com

[Docker] Container란? 컨테이너의 필요성, VM과 차이

dev여름 — Sat, 14 Sep 2024 22:20:21 +0900

이 글은 Udemy 강의 Docker & Kubernetes: The Practical Guide [2024 Edition]을 수강하며 정리한 내용입니다.

Docker란? Container란?

Docker란?

컨테이너를 만들고 관리하는 기술

컨테이너란?

소프트웨어의 표준화된 단위 : 코드 + 그것을 수행하기 위한 dependency들

예를들어 nodeJS 애플리케이션을 빌드하는 경우, 소스코드를 더불어 JavaScript 런타임이 필요한데 Docker로 구축된 컨테이너에서는 항상 동일한 환경에서 일관된 결과물을 얻을 수 있다.

피크닉 바구니에 비유하면 바구니 안에는 요리, 식기 등이 다 들어있고, 우리는 바구니를 들고 원하는 곳 아무데나 가서 피크닉을 할 수 있다. 다 준비되어있기 때문에 음식을 찾기 위해 돌아다니거나 할 필요 없다. 그리고 이 각각의 도구들은 섞이지 않으며, 독립적으로 작용할 수 있고, 필요한 경우 무언가 추가를 하기도 쉽다.

컨테이너의 필요성

우리는 왜 개발에서 독립적이고 표준화된 애플리케이션 패키지를 원하는가?

NodeJs버전 14.3에서만 동작하는 애플리케이션이 있다고 하자. 이것을 배포할 때 배포하고자 하는 환경에는 어떤 버전이 설치되어있을지 모른다. 다른 버전이 설치되어있다면 애플리케이션이 작동하지 않을 수 있다. 도커 컨테이너는 애플리케이션 구동에 필요한 버전까지 모두 포함되어있기 때문에 이러한 종속성 문제를 해결한다.
비슷한 예로, 팀 내 다양한 개발환경이 있을텐데, 같은 노드 애플리케이션을 실행시키고자 하는데, 두 사람간 구성된 환경이 달라 결과가 다르게 나올 수 있다. 도커 컨테이너에서는 항상 동일한 개발환경을 제공해 이러한 번거로움을 없앤다.
단독으로 일하는 경우도 예를들어 두가지 프로젝트에서 서로 다른 파이썬 버전을 사용해야 한다고 할 때, 로컬 환경에서는 두 버전이 충돌하거나 꼬일 수 있다. 각각의 프로젝트는 각자의 컨테이너를 갖고 있기 때문에 충돌할 일이 없으며 로컬에서 개발환경을 구성하는 것 처럼 뭔가 제거하고 재설치하는 과정을 거치지 않아도 된다.

VM과 Container의 차이점

독립된 환경에서 구동되기를 원하는 거면 VM 쓰면 되는거 아님? 이라는 생각을 할수도 있다.

vm은 우리의 컴퓨터 안에 가상의 운영체제를 설치한다. 캡슐화된 가상 머신으로 우리가 필요한 모든 도구를 설치할 수 있다. 여러 OS로 구성할수도 있다. 이런점에서는 도커컨테이너와 비슷하다.

문제는 vm은 우리의 실제 컴퓨터에 할당되는 것이기 때문에 cpu, 메모리 등 엄청 많은 리소스가 필요하다는 것이다. 그리고 독립된 가상의 운영체제가 있더라도 여전히 특정 애플리케이션 개발 및 배포를 위한 환경 구성은 해야하는 상황이기 때문에 좀 까다롭다.

도커컨테이너는 우리 컴퓨터 안에 가상 머신을 설치하지 않는다. 대신 우리가 사용하고 있는 운영체제에 내장되어있거나 에뮬레이트 되어있는 지원을 사용하게 된다. Docker Engine을 실행하고, 모든것은 도커엔진에서 돌아가게 된다. config파일을 통해 공유 및 재빌드가 용이하다.

로컬환경 설치 / VM 환경 / 컨테이너 환경 (출처 : 쿠버네티스 홈페이지)

틀린부분 피드백은 언제나 환영입니다.

[JSON] 기본 JsonPath syntax 문법 정리

dev여름 — Mon, 3 Jun 2024 01:21:19 +0900

참고한 글

https://github.com/json-path/JsonPath

GitHub - json-path/JsonPath: Java JsonPath implementation

Java JsonPath implementation. Contribute to json-path/JsonPath development by creating an account on GitHub.

github.com

https://goessner.net/articles/JsonPath/

JSONPath - XPath for JSON

A frequently emphasized advantage of XML is the availability of plenty tools to analyse, transform and selectively extract data out of XML documents. XPath is one of these powerful tools. It's time to wonder, if there is a need for something like XPath4JSO

goessner.net

그리고 ChatGPT 질의 일부

JSONPath - JSON을 위한 XPath

XPath는 XML구문에서 데이터를 용이하게 추출하기 위한 툴이다.

JSONPath는 특별한 코딩 없이 JSON 구조의 데이터에서 정보를 찾고 추출하기 용이하도록 하는 표준화된 도구(쿼리)이다.

JSONPath를 이용해 클라이언트가 서버에 JSON데이터를 요청하면 딱 필요한 부분만 요청이 가능하기 때문에 서버 응답의 대역폭 사용량을 최소화 할 수 있다.

JSONPath 표현법

JSONPath expression은

dot 표기법이나

$.store.book[0].title

bracket 표기법으로 표현할 수 있다.

$['store']['book'][0]['title']

'$'는 항상 가장 최상단 레벨의 객체를 참조한다.

JSONPath 연산자

goessner.net의 예시 json데이터와 함께 알아본다.

JSONPath Online Evaluator로 연습하면서 직접 해보니 좀 이해가 되는듯 하다..

{
  "store": {
    "book": [
      {
        "category": "reference",
        "author": "Nigel Rees",
        "title": "Sayings of the Century",
        "price": 8.95
      },
      {
        "category": "fiction",
        "author": "Evelyn Waugh",
        "title": "Sword of Honour",
        "price": 12.99
      },
      {
        "category": "fiction",
        "author": "Herman Melville",
        "title": "Moby Dick",
        "price": 8.99
      },
      {
        "category": "fiction",
        "author": "J. R. R. Tolkien",
        "title": "The Lord of the Rings",
        "price": 22.99
      }
    ],
    "bicycle": {
      "color": "red",
      "price": 19.95
    }
  }
}

$.store.book[-2] 같은 음수 인덱스 표현은 JSONPath Online Evaluator에서 동작하지 않음. goessner.net 에도 표현되어있지 않음. Java나 Python등 JSONPath 구현 라이브러리에서만 되는 듯 함
배열 인덱스 범위에서는 음수 인덱스 표현 가능

JSONPath 필터

필터에서 사용되는 연산자들은 JSONPath를 구현한 언어의 라이브러리에 따라 다를 수 있다.

일반적으로 사용되는 주요 연산자들은 아래와 같다.

정규표현식 매칭 연산자인 '=~' 는 JSONPath구현체마다 지원 여부가 다르다.

많이 사용되는 Java 라이브러리 구현체인 Jayway에서는 지원 된다. (참고)

JSONPath 구현체 라이브러리에서 지원하는 연산자는 위의 연산자보다 훨씬 더 다양한 연산자를 지원하고 있다.

기본 문법을 바탕으로 각 라이브러리에서 지원하는 필터, 함수, 연산자를 잘 활용하여 데이터를 추출하는 것이 중요할 것 같다.

하여름의 괴발개발

MCP Server 만들어보기

MCP 기본 구조

MCP Host (호스트)

MCP Client

MCP Server

MCP Server의 3가지 핵심기능

Resources

Tools

Prompt

날씨 어플리케이션 MCP서버 만들기

Context7 MCP 사용해보기 (LLM 할루시네이션 방지)

LLM의 문제점

Context7 이란?

Context7 MCP 서버 Claude Desktop에서 사용해보기

Context7 MCP 사용한 버전

Context7 MCP 사용하지 않은 버전

MCP 개념 및 실습

MCP란?

인터넷 뉴스 레포트 3가지 슬랙으로 보내기 실습

1. 필요한 기능

2. Claude desktop 설치 & MCP 서버 설치

3. 명령 수행

4. 결과물

업무에서 어떤 MCP를 활용할 수 있을까?

MCP의 한계점

Scala Trait

목차

trait의 개념 및 주요 특징

trait 기본 사용법

trait 정의하기

trait 사용하기 (매우 기본)

Java와 차이점

1. 구현된 함수 정의

2. protected 접근제한자 사용

3. 필드 지정

4. 키워드 사용

trait의 선형화

추상클래스와 trait

[Docker] Volume의 정의, 종류, 터미널에서 사용하는 법

Volume이란?

Volume 종류, 예시

Anonymous Volume (익명 볼륨)

Named Volume (이름 지정 볼륨)

컨테이너 실행 시 —rm 옵션을 사용하지 않는 경우 Anonymous Volume

함께 보면 좋은 글

[Docker] Volume과 Bind Mount의 정의, 필요한 이유

Data의 종류

불변 & 읽기 전용 데이터

임시 데이터

영구 데이터

External Data Storage의 종류

[Docker] Image와 Container의 관계, 이미지로 컨테이너 빌드하기

Image vs Container

Container

Image

컨테이너와 이미지의 관계

이미지를 사용해 컨테이너 빌드하기 1 - Docker Hub

함께 보면 좋은 글

[Docker] Container란? 컨테이너의 필요성, VM과 차이

Docker란? Container란?

Docker란?

컨테이너란?

컨테이너의 필요성

VM과 Container의 차이점

[JSON] 기본 JsonPath syntax 문법 정리

JSONPath - JSON을 위한 XPath

JSONPath 표현법

JSONPath 연산자

JSONPath 필터