Joke Generator MCP

Python으로 구축된 간단한 Model Context Protocol (MCP) 서버로, 개발자 및 프로그래밍 관련 농담을 제공합니다.

목표

이 프로젝트는 MCP 서버가 어떻게 구조화되고, 테스트되고, 배포되는지 이해하기 위한 MCP 학습 워크플로우의 일부로 구축되었습니다.

Related MCP server: Jokes MCP Server

기능

• 도구:

  • get_random_joke: 무작위 개발자 농담을 반환합니다.

  • get_joke_by_topic: 특정 프로그래밍 주제(예: Python, JavaScript, CSS)를 기반으로 농담을 반환합니다.

설정 및 설치

1. 저장소 복제 또는 다운로드

2. 의존성 설치: Python 3.10+가 설치되어 있는지 확인하세요. 패키지를 로컬에 설치합니다:

   pip install -e .

사용법 (로컬 테스트)

stdio를 사용하여 MCP 서버를 직접 실행할 수 있습니다:

python -m joke_mcp

MCP Inspector로 테스트

서버를 대화형으로 테스트하려면 공식 MCP Inspector를 사용하세요:

npx @modelcontextprotocol/inspector python -m joke_mcp

이렇게 하면 이 서버에서 제공하는 도구를 호출할 수 있는 로컬 웹 인터페이스가 시작됩니다.

Smithery에 배포

이 프로젝트에는 Smithery 마켓플레이스에 쉽게 배포할 수 있도록 smithery.yaml 구성 파일이 포함되어 있습니다.

1. 코드가 공개 GitHub 저장소에 호스팅되어 있는지 확인하세요.

2. Smithery로 이동하여 "서버 추가"를 클릭하세요.

3. 저장소 URL을 제공하세요. Smithery가 smithery.yaml을 읽고 빌드를 자동으로 구성합니다.

학습 성과

• mcp Python SDK를 사용하여 도구를 만드는 방법을 시연했습니다.

• 표준 Python 패키지 구조를 설정했습니다.

• MCP 마켓플레이스를 통한 공개 공유를 준비했습니다.