Skip to main content
Glama
rzhunemogu-mcp

rzhunemogu-mcp

РжуНеМогу MCP Server

MCP-сервер, который открывает данные крупнейшего русскоязычного архива юмора rzhunemogu.ru для любых ИИ-агентов.

Более 46 000 анекдотов, смешных рассказов, афоризмов, тостов и статусов доступны через стандартный протокол Model Context Protocol.

MCP Node.js PostgreSQL License GitVerse Glama

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

MCP-сервер предоставляет ИИ-агентам 7 инструментов для работы с контентом РжуНеМогу:

Инструмент

Описание

list_categories

Все категории юмора с количеством записей

random_joke

Случайный анекдот (по всем разделам или конкретной категории)

get_joke_by_id

Конкретный анекдот по числовому ID

get_jokes_by_category

Анекдоты категории с пагинацией

search_jokes

Полнотекстовый поиск по ключевым словам («врач», «Штирлиц», «тёща»)

popular_tags

Наиболее часто используемые теги

site_stats

Статистика сайта (число анекдотов, категорий, тегов)

Related MCP server: Rendobar MCP Server

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

Подключение как клиент (рекомендуемый способ)

Общедоступный экземпляр сервера уже развёрнут:

URL: https://rzhunemogu.ru/mcp
Транспорт: streamable HTTP

Добавьте в конфигурацию вашего MCP-клиента:

{
  "mcpServers": {
    "rzhunemogu": {
      "url": "https://rzhunemogu.ru/mcp"
    }
  }
}

Запуск собственного экземпляра

git clone https://github.com/yourname/rzhunemogu-mcp.git
cd rzhunemogu-mcp
npm install
npm run build

# Настройте подключение к PostgreSQL
export DATABASE_URL="postgres://user:password@localhost:5432/rzhunemogu"

# Запуск в режиме streamable HTTP (порт 8081)
export TRANSPORT=http PORT=8081
npm start

# Или в режиме stdio (для локальных агентов)
export TRANSPORT=stdio
npm start

Требования к базе данных

Сервер работает с PostgreSQL 16. Схема:

  • jokes — контент (id, category_id, content, created_at, is_published)

  • categories — категории (id, slug, title, is_adult)

  • tags — теги (id, name)

  • joke_tags — связи анекдот-тег

Полнотекстовый поиск использует русский словарь PostgreSQL (to_tsvector('russian', content)).

🛠 Структура проекта

mcp-server/
├── src/
│   ├── index.ts      # Регистрация инструментов + HTTP/stdio запуск
│   ├── query.ts      # SQL-запросы к базе данных
│   └── db.ts         # Пул подключений PostgreSQL
├── package.json
├── tsconfig.json
└── mcp.json          # Метаданные для реестра MCP

📦 Публикация в реестре MCP

Сервер зарегистрирован в официальном метареестре MCP через mcp.json и доступен в каталогах: Glama, Smithery, mcp.directory, mcp.so.

📄 Лицензия

Проект распространяется под лицензией MIT.

Контент (анекдоты, рассказы, афоризмы) принадлежит rzhunemogu.ru и распространяется с указанием ссылки на источник.

🤝 Связь

Available Tools

7 tools
get_joke_by_idАнекдот по IDA

Возвращает запись юмора по её числовому ID. ID можно получить из search_jokes или random_joke (поле id). Только чтение, без побочных эффектов. Если записи с таким ID нет или она не опубликована — возвращается текст «Анекдот с таким ID не найден».

Inputs: id (required).

get_jokes_by_categoryАнекдоты по категорииA

Возвращает список записей конкретной категории с пагинацией, отсортированных от новых к старым по id (по убыванию). categoryId обязателен (возьми из list_categories). limit — до 50 записей за раз (по умолчанию 15), offset — смещение для пагинации. Только чтение, без побочных эффектов. Ответ содержит total (всего записей в категории) и items (список). Для постраничного просмотра увеличивай offset кратно limit.

Inputs: categoryId (required), limit, offset.

list_categoriesСписок категорийA

Возвращает полный список категорий юмора на РжуНеМогу: id, slug, название, признак «18+», количество опубликованных записей. Только чтение, без побочных эффектов. Ответ — JSON-массив в поле content[0].text. Используй id из этого списка как categoryId в random_joke/get_jokes_by_category.

Inputs: no named parameters.

random_jokeСлучайный анекдотA

Возвращает одну случайную запись (анекдот/историю/афоризм) из базы РжуНеМогу. Если указан categoryId — выбирается случайная запись только из этой категории; иначе из всех опубликованных, включая категории 18+. Только чтение, без побочных эффектов. Повторные вызовы с тем же аргументом могут вернуть разные записи (детерминированности нет). При отсутствии записей в категории возвращается текст «Анекдот не найден».

Inputs: categoryId.

search_jokesПоиск анекдотовA

Полнотекстовый поиск записей по ключевым словам на русском языке (например, «врач», «Штирлиц», «тёща», «теща»). Использует морфологию русского языка PostgreSQL: word-формы приводятся к основе, поэтому «врач» найдёт и «врачи», «врачом» и т.п. Результаты отсортированы по релевантности (ts_rank). query обязателен; поиск без него вернёт пустой результат. Только чтение, без побочных эффектов. limit до 50 (по умолчанию 15), offset для пагинации.

Inputs: query (required), limit, offset.

site_statsСтатистика сайтаA

Возвращает общую статистику базы РжуНеМогу: число опубликованных записей (total_jokes), число категорий (total_categories), число уникальных тегов (total_tags) и дату последнего обновления (last_update). Полезно для получения общего представления о размере и активности базы. Только чтение, без побочных эффектов. Стоимость вызова мала по сравнению с поиском — подходит для быстрых проверок доступности.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a clearly distinct retrieval mode: category enumeration, single random pick, lookup by ID, paginated category listing, full-text search, tag frequency, and aggregate stats. Descriptions explicitly cross-reference each other (e.g. categoryId from list_categories feeds random_joke/get_jokes_by_category), so an agent can pick correctly. No pair of tools is genuinely interchangeable.

    Naming Consistency4/5

    Most names follow a verb_noun pattern (list_categories, get_joke_by_id, get_jokes_by_category, search_jokes), but three are bare noun phrases (random_joke, popular_tags, site_stats). The deviation is minor and the intent of each name remains instantly readable. No casing inconsistency — all snake_case throughout.

    Tool Count5/5

    Seven tools is well-scoped for a read-only joke database: discovery, retrieval by three complementary paths, search, tags, and stats. Every tool earns its place with no filler or trivially overlapping wrapper. Nothing feels thin given the narrow domain.

    Completeness4/5

    The read-only surface is thorough: categories, random, by ID, by category with pagination, full-text search, tags, and stats. The one noticeable gap is that popular_tags surfaces tags but no get_jokes_by_tag tool lets an agent act on them, and there is no explicit 18+ exclusion filter despite the flag being prominent. These are workarounds-able but real dead ends.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers