# styx-mcp-server

MCP-сервер подключает клиента к вашему Styx — шлюзу, который распределяет запросы между OpenAI, Anthropic, Google и Mistral.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Автор: timmx7
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/timmx7/styx/tree/HEAD/styx-mcp-server
- Обновлён: 2026-06-08
- HTML: https://affpapa.org/nevibecode/mcp/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.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `STYX_API_KEY`, `STYX_TOKEN`, `STYX_API_URL`, `STYX_PROXY_URL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- отправить запрос через шлюз Styx, не переключая клиента
- посмотреть доступные модели и их цены
- задать модель по умолчанию для дальнейших запросов
- создать проект и выпустить для него API-ключ
- проверить расход и стоимость по своим запросам

## Примеры запросов агенту
- Покажи список моделей с ценами через styx_list_models
- Отправь этот промпт через шлюз и верни ответ
- Создай проект и выпусти для него API-ключ

## Похожие
- [lemonade-router-builder](https://affpapa.org/nevibecode/skills/lemonade-router-builder.md) — скилл · 809 установок
- [omni-providers](https://affpapa.org/nevibecode/skills/omni-providers.md) — скилл · 1100 установок
- [gpt2api-openai-gateway](https://affpapa.org/nevibecode/skills/gpt2api-openai-gateway.md) — скилл · 378 установок
- [llm-gateway](https://affpapa.org/nevibecode/skills/llm-gateway.md) — скилл · 333 установки
- [node-connect](https://affpapa.org/nevibecode/skills/node-connect.md) — скилл · 793 установки
- [Agent MCP Gateway](https://affpapa.org/nevibecode/mcp/agent-mcp-gateway.md) — MCP-сервер · ★ 41

Из того же набора: [timmx7/styx](https://affpapa.org/nevibecode/by/timmx7/styx.md) — 2 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md