🎭 Joke MCP Server

Простой, но мощный сервер Model Context Protocol (MCP), который добавляет юмор во взаимодействие с ИИ. Этот MCP предоставляет генерацию случайных шуток в виде инструментов, которые можно легко интегрировать с Claude и другими MCP-совместимыми клиентами.

✨ Возможности

• get_random_joke — Получить случайную шутку с вступлением и развязкой

• count_jokes — Получить общее количество доступных шуток в базе данных

• Простой и лёгкий — Минимальные зависимости, быстрое выполнение

• Лёгкая интеграция — Работает с Claude Desktop и другими MCP-клиентами

• Хорошо документирован — Понятные схемы и примеры использования

Related MCP server: Jokes MCP Server

🚀 Быстрый старт

Предварительные требования

• Python 3.11 или выше

• Менеджер пакетов pip

Установка

# Clone the repository
git clone https://github.com/tehrimaly/mcp-joke.git
cd mcp-joke

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On Windows:
venv\Scripts\Activate.ps1
# On macOS/Linux:
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

Запуск сервера

python joke-mcp.py

Вы должны увидеть:

🚀 Joke MCP Server starting...

📖 Использование

С Claude Desktop

Добавьте это в файл конфигурации Claude Desktop:

macOS/Linux: ~/.config/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "joke-mcp": {
      "command": "python",
      "args": ["/path/to/joke-mcp.py"]
    }
  }
}

Затем перезапустите Claude Desktop, и вы сможете попросить Claude рассказывать шутки!

Справочник API

get_random_joke

Возвращает случайную шутку с вступлением и развязкой.

Входные данные: нет

Выходные данные:

Setup: Why don't scientists trust atoms?

Punchline: Because they make up everything!

count_jokes

Возвращает общее количество шуток, доступных в базе данных.

Входные данные: нет

Выходные данные:

Total jokes: 5

🏗️ Структура проекта

mcp-joke/
├── joke-mcp.py          # Main MCP server implementation
├── requirements.txt      # Python dependencies
├── README.md            # This file
├── .gitignore           # Git configuration
└── LICENSE              # MIT License

🔧 Технические детали

Создано с помощью

• Python 3.11+ — Язык программирования

• MCP SDK v1.0.0 — Библиотека Model Context Protocol

• Asyncio — Асинхронное программирование

Как это работает

Joke MCP Server:

1. Запускает MCP-сервер, прослушивающий stdio

2. Регистрирует доступные инструменты с их схемами

3. Обрабатывает входящие запросы от MCP-клиентов

4. Возвращает отформатированные ответы с данными о шутках

# Tool registration example
@server.list_tools()
async def list_tools():
    return [
        Tool(
            name="get_random_joke",
            description="Get a random joke",
            inputSchema={...}
        )
    ]

# Tool execution
@server.call_tool()
async def call_tool(name: str, arguments: dict):
    if name == "get_random_joke":
        # Return random joke

📦 Зависимости

• mcp==1.0.0 — Model Context Protocol SDK

Полный список зависимостей см. в requirements.txt.

🎯 Текущие возможности

✅ 5 встроенных шуток ✅ Поддержка async/await ✅ Чистая обработка ошибок ✅ Простое определение инструментов на основе схем ✅ Логирование в stdout

🔮 Планируемые улучшения

• Добавить категории шуток (бородатые анекдоты, каламбуры, чёрный юмор)

• Реализовать уровни сложности

• Добавить рейтинги/отзывы на шутки

• Подключить внешние API шуток

• Сохранять избранное пользователей

• Поддержка нескольких языков

• Веб-интерфейс для управления шутками

🤝 Вклад в проект

Не стесняйтесь:

• Добавлять больше шуток в базу данных

• Улучшать документацию

• Сообщать об ошибках

• Предлагать новые функции

📝 Лицензия

Этот проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

🔗 Ссылки

• GitHub: https://github.com/tehrimaly/mcp-guide

• Спецификация MCP: https://spec.modelcontextprotocol.io/

• Документация Anthropic MCP: https://modelcontextprotocol.io/

💡 Примеры использования

1. Интеграция с ИИ-ассистентом — Добавьте юмор во взаимодействие с Claude

2. Slack-бот — Интегрируйте шутки в командное общение

3. Обучающий инструмент — Поймите основы реализации MCP

4. Шаблон — Используйте как отправную точку для собственных MCP-серверов

🐛 Устранение неполадок

Проблема: Ошибка «Module not found»

pip install -r requirements.txt

Проблема: Порт уже занят Сервер использует stdio, а не порт. Этого не должно произойти.

Проблема: Сервер не запускается

• Проверьте версию Python (3.11+)

• Убедитесь, что все зависимости установлены

• Проверьте наличие синтаксических ошибок

📧 Поддержка

По вопросам, проблемам или предложениям, пожалуйста, создайте issue на GitHub.