# CAPI Gateway

Превращает существующий REST API в MCP-инструмент без правок на бэкенде. Сервис регистрируется в Consul, и агент сразу видит его инструменты.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Автор: surisoft-io
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/surisoft-io/capi-core
- Обновлён: 2026-10-13
- HTML: https://affpapa.org/nevibecode/mcp/capi-gateway

## Что делает

CAPI Gateway — это API-шлюз на асинхронном прокси Undertow, который умеет выставлять сервисы наружу как MCP-инструменты для LLM-агентов. Бэкенды остаются обычными REST-сервисами: CAPI сам читает метаданные из Consul, собирает каталог инструментов и переводит вызовы `tools/call` в HTTP-запросы к вашему API. Ответ оборачивается обратно в формат MCP.

Кроме REST-бэкендов поддерживаются и настоящие MCP-серверы: их регистрируют с `mcp-type: server`, и CAPI сам забирает их инструменты через `tools/list`. Оба типа попадают в один общий MCP-эндпоинт. Сам MCP-шлюз помечен как экспериментальный, как и gRPC-шлюз.

Запуск идёт из JAR, Docker или Helm-чарта, и обязательна переменная окружения `CAPI_CONFIG_FILE` с путём к конфигу — без неё сервер не стартует. MCP-порт по умолчанию 8383 (`capi.mcp.port`). Для установки в агент нужен Docker: команда поднимает образ `docker.io/surisoft/capi-core:1.417.5` в интерактивном режиме.

## Требования
- Нужно: Docker

## Установка

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

**Командой платформы**
```bash
claude mcp add capi-gateway -- docker run -i --rm docker.io/surisoft/capi-core:1.417.5
```

### Codex

**Командой платформы**
```bash
codex mcp add capi-gateway -- docker run -i --rm docker.io/surisoft/capi-core:1.417.5
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "capi-gateway": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/surisoft/capi-core:1.417.5"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "capi-gateway": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/surisoft/capi-core:1.417.5"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add capi-gateway docker run -i --rm docker.io/surisoft/capi-core:1.417.5
```

## Когда брать
- открыть существующий REST API агенту без переписывания бэкенда
- собрать каталог инструментов из сервисов, зарегистрированных в Consul
- проксировать вызовы MCP-серверов через один общий эндпоинт
- проверить маршруты и метрики шлюза через Admin API
- добавить валидацию OAuth2/OIDC-токенов перед вызовом бэкенда

## Примеры запросов агенту
- Покажи список инструментов, которые отдаёт CAPI Gateway
- Вызови инструмент из CAPI и покажи ответ бэкенда
- Зарегистрируй новый сервис в Consul с MCP-метаданными

## Похожие
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16717
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/nevibecode/mcp/openwork-mcp-gateway.md) — MCP-сервер · ★ 24242
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Nhost](https://affpapa.org/nevibecode/mcp/nhost.md) — MCP-сервер · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP-сервер · ★ 7506

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