GitHub 저장소를 이용한 Smithery 서버 등록 및 배포

GitHub 저장소를 이용한 Smithery 서버 등록 및 배포

Smithery는 GitHub 저장소 기반으로 MCP 서버를 자동 등록 및 배포할 수 있는 강력한 기능을 제공합니다.

1. 필수 파일 준비

• Dockerfile: 서버 실행 환경을 정의합니다.
• smithery.yaml: 실행 명령과 환경변수를 선언합니다.

두 파일은 저장소 루트에 있어야 하며, MCP 서버를 정의하는 표준 형식에 따라 작성되어야 합니다.

2. smithery.yaml

MCP 서버가 어떤 환경변수를 필요로 하는지 정의하고, 실행 명령어를 구성하는 설정 파일입니다.

startCommand:
  type: stdio
  configSchema:
    type: object
    required:
      - youtubeApiKey
    properties:
      youtubeApiKey:
        type: string
        description: YouTube API Key
  commandFunction:
    |-
    (config) => ({
      command: 'python',
      args: ['server.py'],
      env: {
        YOUTUBE_API_KEY: config.youtubeApiKey
      }
    })
  exampleConfig:
    youtubeApiKey: your_youtube_api_key_here

3. GitHub 저장소를 통한 서버 등록

1. smithery.ai에 접속해 로그인합니다.
2. 상단 메뉴에서 [Add Server]를 클릭합니다.
3. [Continue with GitHub]을 눌러 저장소 권한을 부여합니다.
4. MCP 서버가 포함된 저장소를 선택하면, Dockerfile과 smithery.yaml을 자동 인식하여 MCP 서버로 등록됩니다.

4. 서버 배포 및 설정

• 등록된 MCP 서버의 [Deployments] 탭으로 이동해 [Deploy] 버튼을 클릭하면 서버가 배포됩니다.
• [Settings] 탭에서는 MCP 서버의 실행 환경이나 기본 설정(configSchema) 등을 수정할 수 있습니다.
• 배포 완료 후 Claude, Cursor IDE에서 서버를 자동으로 인식해 사용할 수 있습니다.

 

함께 읽으면 좋은 글

• Youtube API를 이용하여 MCP Server를 만들어보자
• https://modelcontextprotocol.io/introduction

Youtube API를 이용하여 MCP Server를 만들어보자.

Introduction - Model Context Protocol

https://smithery.ai/

Smithery - Model Context Protocol Registry