styx-mcp-server — MCP-сервер для Claude Code
MCP-сервер подключает клиента к вашему Styx — шлюзу, который распределяет запросы между OpenAI, Anthropic, Google и Mistral.
claude mcp add --env STYX_API_KEY=<STYX_API_KEY> --env STYX_TOKEN=<STYX_TOKEN> --env STYX_API_URL=<STYX_API_URL> --env STYX_PROXY_URL=<STYX_PROXY_URL> --transport stdio styx-mcp-server -- npx -y styx-mcp-serverЧто делает styx-mcp-server
Сервер даёт агенту девять инструментов: styx_send_request отправляет запрос через шлюз, styx_list_models показывает доступные модели с ценами, styx_switch_model задаёт модель по умолчанию. Отдельная группа — работа с проектами и ключами: styx_list_projects, styx_create_project, styx_list_api_keys, styx_create_api_key, styx_check_usage и styx_manage_providers для ключей BYOK.
Перед запуском нужен Node.js 18+ и Python 3.10+ с пакетами mcp[cli], httpx и pydantic. Адреса бэкенда и прокси задаются переменными STYX_API_URL и STYX_PROXY_URL, по умолчанию это http://localhost:8000 и http://localhost:8080. Без STYX_API_KEY инструмент styx_send_request работать не будет, а STYX_TOKEN нужен для управления проектами и ключами — так что заведите оба до первого запуска.
Кроме stdio есть режим SSE: npx styx-mcp-server --sse поднимает сервер на порту 8090. Лицензия — Apache-2.0.
Какие задачи решает
- отправить запрос через шлюз Styx, не переключая клиента
- посмотреть доступные модели и их цены
- задать модель по умолчанию для дальнейших запросов
- создать проект и выпустить для него API-ключ
- проверить расход и стоимость по своим запросам
Примеры запросов агенту
- Покажи список моделей с ценами через styx_list_models
- Отправь этот промпт через шлюз и верни ответ
- Создай проект и выпусти для него API-ключ
Как установить styx-mcp-server
Командой платформы
claude mcp add --env STYX_API_KEY=<STYX_API_KEY> --env STYX_TOKEN=<STYX_TOKEN> --env STYX_API_URL=<STYX_API_URL> --env STYX_PROXY_URL=<STYX_PROXY_URL> --transport stdio styx-mcp-server -- npx -y styx-mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add styx-mcp-server --env STYX_API_KEY=<STYX_API_KEY> --env STYX_TOKEN=<STYX_TOKEN> --env STYX_API_URL=<STYX_API_URL> --env STYX_PROXY_URL=<STYX_PROXY_URL> -- npx -y styx-mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"styx-mcp-server": {
"command": "npx",
"args": [
"-y",
"styx-mcp-server"
],
"env": {
"STYX_API_KEY": "<STYX_API_KEY>",
"STYX_TOKEN": "<STYX_TOKEN>",
"STYX_API_URL": "<STYX_API_URL>",
"STYX_PROXY_URL": "<STYX_PROXY_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"styx-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"styx-mcp-server"
],
"env": {
"STYX_API_KEY": "<STYX_API_KEY>",
"STYX_TOKEN": "<STYX_TOKEN>",
"STYX_API_URL": "<STYX_API_URL>",
"STYX_PROXY_URL": "<STYX_PROXY_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e STYX_API_KEY=<STYX_API_KEY> -e STYX_TOKEN=<STYX_TOKEN> -e STYX_API_URL=<STYX_API_URL> -e STYX_PROXY_URL=<STYX_PROXY_URL> styx-mcp-server npx -y styx-mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о styx-mcp-server
Как установить styx-mcp-server в Claude Code?
Выполните claude mcp add styx-mcp-server -e STYX_API_KEY=<STYX_API_KEY> -e STYX_TOKEN=<STYX_TOKEN> -- npx -y styx-mcp-server. Второй способ передаёт ещё и адреса: `claude mcp add --env STYX_API_KEY=<STYX_API_KEY> --env STYX_TOKEN=<STYX_TOKEN> --env STYX_API_URL=<STYX_API_URL> --env STYX_PROXY_URL=<STYX_PROXY_URL> --transport stdio styx-mcp-server -- npx -y styx-mcp-server`.
Что делает styx-mcp-server?
Соединяет MCP-клиент с вашим Styx и отдаёт агенту инструменты для маршрутизации запросов, выбора модели, работы с проектами, ключами и статистикой расходов.
Какие переменные окружения нужны?
STYX_API_URL и STYX_PROXY_URL задают адреса бэкенда и прокси, STYX_API_KEY нужен для отправки запросов, а STYX_TOKEN — для управления проектами и ключами.
