[Docker] docker image 를 docker hub 에 배포하기

 

 

 

내가 자체 개발한 MCP server 를 docker image 로 배포하고 cursor 또는 claude 와 같은 MCP Client 에 설치해서 사용하려고한다.

python 으로 개발한 MCP Server 을 docker image 로 빌드 배포하고 MCP Client 에 세팅하는 과정까지 정리해보았다.

 

⭐️자체 개발한 mcp:

-github: https://github.com/hyeri0903/naver-works-mcp

-블로그 글: https://hyeri0903.tistory.com/383

1. Docker hub

docker hub 에서 이미지를 push 할 repository 를 생성한다.

https://hub.docker.com/

Docker Hub Container Image Library | App Containerization

 

 

• Docker Hub에 로그인
• "Create Repository" 클릭
• Repository 이름 입력 (이미지 이름과 일치해야 함)
• Public/Private 선택
• Create 클릭

 

 

2.Docker Image build & push 하기

빌드 및 배포 명령어

# Dockerfile이 있는 디렉토리로 이동
cd /path/to/your/project

# 이미지 빌드
docker build -t your-username/your-project:latest .

# Docker Hub에 푸시
docker push your-username/your-project:latest

- latest 대신 다른 tag name 을 사용해도된다.

Dockerfile 이 존재하는 프로젝트가 아닌 다른 위치에서 실행하려면

# 다른 디렉토리에서 실행할 경우 경로 지정
docker build -t your-username/your-project:latest /path/to/dockerfile/directory

 

⭐️⭐️주의사항

마지막의 점(.)이 중요합니다

• .은 현재 디렉토리를 빌드 컨텍스트로 지정
• 이 디렉토리의 모든 파일이 Docker 데몬으로 전송됩니다

 

docker desktop 에서 이미지가 잘 뜨는 것 확인

 

3. Docker Login

 

docker push 하는데 authorization failed 가 발생했다!

docker login 을 안해서 오류가 발생한 것!

# Docker Hub에 로그인
docker login

# Username과 Password 입력
Username: your-dockerhub-username
Password: your-dockerhub-password

 

브라우저로 이동해서 로그인을 진행했다.

 

# 현재 로그인 상태 확인
docker info | grep Username

 

 

로그인 완료 후 다시 docker push 하니 정상적으로 완료되었다!

 

docker hub repository 에서 확인해보면 정상적으로 이미지가 올라온 것 확인!

 

4. MCP Server Setting

cursor 의 mcp.json 파일에서 docker 기반으로 동작하도록 세팅해준다.

 

 

정상적으로 세팅 완료!

mcp tool 조회도 잘 된다.

 

 

 

테스트해보니 데이터를 잘 가져온다!