Napkin — MCP-сервер для Claude Code: визуалы из текста
Napkin создаёт схемы, инфографику и иллюстрации по текстовому запросу через MCP. Пригодится, когда агенту нужно подготовить визуал и сохранить его на диск.
claude mcp add --env NAPKIN_API_KEY=<NAPKIN_API_KEY> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> --env NAPKIN_REQUEST_TIMEOUT_MS=<NAPKIN_REQUEST_TIMEOUT_MS> --transport stdio napkin -- npx -y @mindstone/mcp-server-napkinЧто делает Napkin
Сервер подключает Napkin AI к MCP-хосту. Агент может запустить генерацию, проверить её статус и скачать готовый файл. Для работы нужен API-ключ Napkin AI в переменной NAPKIN_API_KEY; сохранение файлов можно направить в рабочую папку через MCP_WORKSPACE_PATH.
В наборе есть отдельные инструменты для генерации, проверки статуса и скачивания, а также каталог встроенных стилей. Список стилей доступен без API-ключа и сетевого запроса. API Napkin находится в предварительной версии, поэтому его конечные точки и поведение могут меняться.
Какие задачи решает
- создать иллюстрацию по текстовому описанию
- собрать инфографику для документа
- проверить статус генерации визуала
- скачать готовый файл в рабочую папку
- выбрать стиль из встроенного каталога
Примеры запросов агенту
- Создай схему архитектуры по этому описанию.
- Проверь статус последней генерации визуала.
- Скачай готовый визуал в рабочую папку.
Как установить Napkin
Командой платформы
claude mcp add --env NAPKIN_API_KEY=<NAPKIN_API_KEY> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> --env NAPKIN_REQUEST_TIMEOUT_MS=<NAPKIN_REQUEST_TIMEOUT_MS> --transport stdio napkin -- npx -y @mindstone/mcp-server-napkinВместо <…> подставьте свои значения
Командой платформы
codex mcp add napkin --env NAPKIN_API_KEY=<NAPKIN_API_KEY> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> --env NAPKIN_REQUEST_TIMEOUT_MS=<NAPKIN_REQUEST_TIMEOUT_MS> -- npx -y @mindstone/mcp-server-napkinВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"napkin": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-napkin"
],
"env": {
"NAPKIN_API_KEY": "<NAPKIN_API_KEY>",
"MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>",
"NAPKIN_REQUEST_TIMEOUT_MS": "<NAPKIN_REQUEST_TIMEOUT_MS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"napkin": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-napkin"
],
"env": {
"NAPKIN_API_KEY": "<NAPKIN_API_KEY>",
"MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>",
"NAPKIN_REQUEST_TIMEOUT_MS": "<NAPKIN_REQUEST_TIMEOUT_MS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e NAPKIN_API_KEY=<NAPKIN_API_KEY> -e MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> -e NAPKIN_REQUEST_TIMEOUT_MS=<NAPKIN_REQUEST_TIMEOUT_MS> napkin npx -y @mindstone/mcp-server-napkinВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Napkin
Как установить Napkin в Claude Code?
Выполните claude mcp add mcp-server-napkin -e NAPKIN_API_KEY=<NAPKIN_API_KEY> -- npx -y @mindstone/mcp-server-napkin. Подставьте API-ключ Napkin вместо <NAPKIN_API_KEY>.
Что делает Napkin?
MCP-сервер передаёт запросы на создание визуалов в Napkin AI. Через него агент также проверяет статус генерации и скачивает результат.
Нужен ли API-ключ для просмотра стилей?
Нет. Инструмент napkin_list_styles показывает встроенный каталог стилей без обращения к API.
