rzhunemogu-mcp
It gives AI agents access to the rzhunemogu.ru humor archive through 7 MCP tools.
List all joke categories with record counts and 18+ flags.
Fetch a random joke, optionally from a specific category.
Retrieve a specific joke by numeric ID.
Browse jokes in a category with pagination.
Full-text search jokes by keywords.
Get the most popular tags.
View site statistics: joke, category, and tag counts plus last update date.
РжуНеМогу MCP Server
MCP-сервер, который открывает данные крупнейшего русскоязычного архива юмора rzhunemogu.ru для любых ИИ-агентов.
Более 46 000 анекдотов, смешных рассказов, афоризмов, тостов и статусов доступны через стандартный протокол Model Context Protocol.
✨ Возможности
MCP-сервер предоставляет ИИ-агентам 7 инструментов для работы с контентом РжуНеМогу:
Инструмент | Описание |
| Все категории юмора с количеством записей |
| Случайный анекдот (по всем разделам или конкретной категории) |
| Конкретный анекдот по числовому ID |
| Анекдоты категории с пагинацией |
| Полнотекстовый поиск по ключевым словам («врач», «Штирлиц», «тёща») |
| Наиболее часто используемые теги |
| Статистика сайта (число анекдотов, категорий, тегов) |
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 и распространяется с указанием ссылки на источник.
🤝 Связь
Сайт: rzhunemogu.ru
E-mail: support@RzhuNeMogu.ru
Разработчик: MihaNikUs
Available Tools
7 toolsget_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.
popular_tagsПопулярные тегиA
Возвращает наиболее часто используемые теги записей, отсортированные по убыванию частоты (count). Показывает темы, чаще всего встречающиеся в базе РжуНеМогу. Только чтение, без побочных эффектов. limit задаёт сколько тегов вернуть (1-100, по умолчанию 30). Каждый тег — {name, count}, где count — число записей с этим тегом.
Inputs: limit.
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
Scored across 7 tools
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.
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.
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.
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
Related MCP Connectors
Read-only, no-auth MCP server over Human x AI's Content Hub and confirmed 2027 facts.
MCP server for AI dialogue using various LLM models via AceDataCloud
MCP server for Qwen Image 3 AI image generation
Related MCP Servers
- AlicenseBqualityDmaintenanceA Minecraft MCP Server powered by Mineflayer API. It allows to control a Minecraft character in real-time, allowing AI assistants to build structures, explore the world, and interact with the game environment through natural language instruction22266 npm822Apache 2.0
- AlicenseAqualityBmaintenanceOfficial MCP server for Rendobar. Lets AI agents run serverless media processing and upload local files.984 npm1MIT
- AlicenseBqualityBmaintenanceMCP server for BrewPage, a free no-signup hosting service. Lets AI agents publish HTML, Markdown, JSON, files, or a full multi-file static site and get a public URL instantly via a REST API.135Apache 2.0

@byimprint/mcp-serverofficial
AlicenseNot gradedqualityFmaintenanceRetired MCP server for byImprint's historical creator-intelligence experiment. It is no longer active.16 npmMIT