Hello World MCP Server

간단한 Hello World 기능을 제공하는 MCP (Model Context Protocol) 서버입니다.

기능

이 MCP 서버는 다음과 같은 도구들을 제공합니다:

1. hello_world - 이름을 받아서 인사말을 반환합니다

   • 매개변수: name (선택사항, 기본값: "World")
   • 예시: hello_world(name="Alice") → "Hello, Alice! 👋"

2. get_greeting - 다양한 언어로 인사말을 반환합니다

   • 매개변수: language (필수)
   • 지원 언어: english, korean, spanish, french, japanese
   • 예시: get_greeting(language="korean") → "안녕하세요! 오늘 어떻게 지내세요?"

빠른 시작 (권장)

사전 요구사항

• UV (Python 패키지 관리 도구)

  # macOS
  brew install uv
  
  # 기타 OS
  # https://docs.astral.sh/uv/getting-started/installation/

npx로 바로 사용하기

AI 도구(Cursor, Claude Desktop 등)의 MCP 설정에 다음 내용을 추가합니다:

{
  "mcpServers": {
    "hello-world": {
      "command": "npx",
      "args": ["-y", "@baehongjun0212/hello-world-mcp-server@latest"]
    }
  }
}

설정 후 AI 도구를 재시작하면 바로 사용할 수 있습니다!

개발자를 위한 설치 방법

1. 소스에서 설치

# 저장소 클론
git clone <repository-url>
cd hello-world-mcp-server

# Python 의존성 설치
uv sync

# (선택사항) Node.js 의존성 설치 (npm 배포를 위해)
npm install

2. 개발 환경에서 실행

# Python으로 직접 실행
uv run hello-world-mcp-server

# 또는 Node.js wrapper로 실행
node bin/hello-world-mcp-server.js

3. AI 도구에 로컬 개발 버전 등록

{
  "mcpServers": {
    "hello-world-dev": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/hello-world-mcp-server",
        "run",
        "hello-world-mcp-server"
      ]
    }
  }
}

npm 패키지 배포 (관리자용)

1. npm 로그인

npm login

2. 패키지 이름 변경

package.json에서 @your-username을 실제 npm 사용자명으로 변경:

{
  "name": "@your-username/hello-world-mcp-server",
  ...
}

3. 배포

npm publish --access public

프로젝트 구조

hello-world-mcp-server/
├── bin/
│   └── hello-world-mcp-server.js  # Node.js 실행 파일
├── lib/
│   └── index.js                   # Node.js API
├── src/
│   └── hello_world_mcp_server/
│       ├── __init__.py
│       ├── __main__.py           # Python 진입점
│       └── server.py             # MCP 서버 구현
├── package.json                  # npm 패키지 설정
├── pyproject.toml               # Python 프로젝트 설정
├── README.md                    # 이 문서
├── .gitignore
├── .npmignore                   # npm 배포 제외 파일
└── .python-version

개발

테스트 실행

uv run pytest

코드 린팅

uv run ruff check .
uv run ruff format .

문제 해결

"uv is not installed" 오류

UV가 설치되지 않았습니다. 다음 명령으로 설치하세요:

brew install uv  # macOS

Python 버전 오류

Python 3.12 이상이 필요합니다. UV는 자동으로 올바른 Python 버전을 관리합니다.

라이선스

MIT License