Joke Generator MCP

Простой сервер Model Context Protocol (MCP), написанный на Python, который предоставляет шутки для разработчиков и о программировании.

Цель

Этот проект создан в рамках учебного процесса по изучению 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 .

Использование (локальное тестирование)

Вы можете запустить сервер MCP напрямую через stdio:

python -m joke_mcp

Тестирование с помощью MCP Inspector

Для интерактивного тестирования сервера используйте официальный MCP Inspector:

npx @modelcontextprotocol/inspector python -m joke_mcp

Это запустит локальный веб-интерфейс, где вы сможете вызывать инструменты, предоставляемые этим сервером.

Развертывание на Smithery

В этот проект включен файл конфигурации smithery.yaml для простого развертывания на маркетплейсе Smithery.

1. Убедитесь, что ваш код размещен в публичном репозитории на GitHub.

2. Перейдите на Smithery и нажмите "Add Server".

3. Укажите URL вашего репозитория. Smithery прочитает smithery.yaml и автоматически настроит сборку.

Результаты обучения

• Продемонстрировано, как использовать Python SDK mcp для создания инструментов.

• Настроена стандартная структура Python-пакета.

• Подготовлен проект для публичного размещения через маркетплейс MCP.