zoo-mcp — MCP-сервер для Claude Code: CAD-операции через Zoo API
MCP-сервер с инструментами Zoo: выполняет KCL-код, импортирует CAD-файлы, делает снимки и замеры моделей прямо из агента.
claude mcp add zoo-mcp -e ZOO_TOKEN=<ZOO_TOKEN> -- uvx zoo_mcpЧто делает zoo-mcp
Сервер оборачивает API Zoo и отдаёт агенту набор инструментов для работы с геометрией. Через execute_kcl и exec_kcl_project он запускает KCL-код, import_cad_file подтягивает готовые модели, а snapshot и инструменты камеры показывают сцену. Есть отдельный набор для публичных проектов Aquarium: их можно искать и скачивать без токена.
Моделирование идёт через явные сессии: на один процесс сервера открыта максимум одна. После переподключения клиента её ID возвращает get_modeling_session, а если сессии нет — её создаёт start_modeling_session. Тот же session_id передаётся в снимки и инструменты моделирования, в конце сессию закрывает stop_modeling_session. Рендеринг включается на первом снимке или выделении и живёт до остановки сессии, поэтому состояние картинки сохраняется между вызовами. Экспорт, замеры и запросы геометрии графику не поднимают.
Для работы нужен ключ API Zoo и переменная окружения ZOO_API_TOKEN — без неё сервер не запустится. Локальные точки входа принимают также KITTYCAD_API_TOKEN и алиас ZOO_TOKEN, а происхождение API задаётся через ZOO_HOST или KITTYCAD_HOST. По умолчанию транспорт stdio; для Streamable HTTP сервер запускают с --transport streamable-http, а клиент подключают к http://127.0.0.1:8000/mcp.
Какие задачи решает
- выполнить KCL-код и получить результат прямо из агента
- импортировать CAD-файл в сцену моделирования
- сделать снимок модели и посмотреть её состояние
- найти публичный проект Aquarium и скачать его исходники
- провести замеры и запросы геометрии без запуска графики
Примеры запросов агенту
- Выполни этот KCL-код и покажи, что получилось
- Импортируй
bracket.stepв сессию моделирования и сделай снимок - Найди публичный проект Aquarium по имени и скачай его KCL-исходники
Как установить zoo-mcp
Командой платформы
claude mcp add zoo-mcp -e ZOO_TOKEN=<ZOO_TOKEN> -- uvx zoo_mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from zoo_mcp <команда>
Командой платформы
codex mcp add zoo-mcp --env ZOO_TOKEN=<ZOO_TOKEN> -- uvx zoo_mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from zoo_mcp <команда>
Файл настроек
{
"mcpServers": {
"zoo-mcp": {
"command": "uvx",
"args": [
"zoo_mcp"
],
"env": {
"ZOO_TOKEN": "<ZOO_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from zoo_mcp <команда>
Файл настроек
{
"servers": {
"zoo-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"zoo_mcp"
],
"env": {
"ZOO_TOKEN": "<ZOO_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from zoo_mcp <команда>
Командой платформы
gemini mcp add -e ZOO_TOKEN=<ZOO_TOKEN> zoo-mcp uvx zoo_mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from zoo_mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о zoo-mcp
Как установить zoo-mcp в Claude Code?
Добавьте сервер командой claude mcp add zoo-mcp -e ZOO_TOKEN=<ZOO_TOKEN> -- uvx zoo_mcp. Второй вариант — claude mcp add --env ZOO_TOKEN=<ZOO_TOKEN> --transport stdio zoo-mcp -- uvx zoo_mcp.
Что делает zoo-mcp?
Даёт агенту инструменты Zoo для CAD: выполнение KCL-кода, импорт файлов, снимки, замеры и работу с публичными проектами Aquarium.
Что нужно для запуска zoo-mcp?
Ключ API Zoo в переменной ZOO_API_TOKEN. Локальные точки входа принимают также KITTYCAD_API_TOKEN и алиас ZOO_TOKEN.
