Aesthetics Wiki MCP

PyPI version Python versions License: MIT

MCP-сервер, который позволяет LLM искать, читать и открывать для себя эстетики из Aesthetics Wiki (коттеджкор, темная академия, y2k, гоблинкор и тысячи других).

Работает на базе API MediaWiki. API-ключ не требуется. Нулевая настройка: запускайте напрямую через uvx.

Инструменты

Инструмент	Описание
`search_aesthetic(query, limit=10)`	Полнотекстовый поиск по вики.
`get_aesthetic(name, max_chars=6000)`	Получение очищенного контента страницы + URL основного изображения.
`get_aesthetic_images(name, limit=12)`	Галерея URL-адресов изображений со страницы — идеально для мудбордов.
`list_related(name, limit=20)`	Список эстетик, на которые есть ссылки со страницы (соседние/связанные).
`random_aesthetic(count=1)`	Выбор случайных эстетик для вдохновения.

Все инструменты работают только для чтения.

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

Требуется Python 3.10+ и uv. Ничего не нужно устанавливать вручную — uvx загружает и запускает сервер по требованию.

Claude Code / Claude Desktop

Добавьте это в свою конфигурацию MCP (~/.claude/settings.json, проектный .mcp.json или ~/Library/Application Support/Claude/claude_desktop_config.json на macOS):

{
  "mcpServers": {
    "aesthetics-wiki": {
      "command": "uvx",
      "args": ["aesthetics-wiki-mcp"]
    }
  }
}

Перезапустите клиент, и 5 инструментов появятся автоматически.

Другие MCP-клиенты

Работает любой клиент, поддерживающий stdio. Просто используйте uvx aesthetics-wiki-mcp в качестве команды транспорта.

Установка вручную

uv tool install aesthetics-wiki-mcp      # or: pipx install aesthetics-wiki-mcp
aesthetics-wiki-mcp                       # starts the stdio server

Примеры запросов

"Найди эстетики, связанные с темной академией, и покажи мне визуальный мудборд."
"Дай мне 5 случайных эстетик и опиши атмосферу каждой одним предложением."
"Каковы основные элементы коттеджкора? Есть ли смежные эстетики, о которых мне стоит знать?"
"Сравни эстетику y2k и Tumblr 2014 года."

Разработка

uv sync
uv run aesthetics-wiki-mcp        # start stdio server
uv run python -m py_compile src/aesthetics_wiki_mcp/server.py

Протестируйте интерактивно с помощью MCP Inspector:

npx @modelcontextprotocol/inspector uv run aesthetics-wiki-mcp

Лицензия

MIT. Контент из Aesthetics Wiki лицензирован авторами по лицензии CC-BY-SA 3.0; этот проект лишь проксирует доступ для чтения и указывает источник в каждом URL ответа.