mcp-akiko-proxy

MCP stdio-прокси через SSH, предоставляющий удалённые MCP-серверы (привязанные к localhost на удалённой машине) как инструменты на локальной машине.

Устанавливает SSH-туннели, используя ваш существующий алиас хоста из ~/.ssh/config, подключается к удалённым MCP-серверам через streamable-http по туннелю и предоставляет их инструменты, объединённые за одним локальным stdio MCP-сервером.

Цели по умолчанию (настраиваются):

Graceful degradation

Если туннель недоступен или бэкенд не отвечает, инструменты этого бэкенда исчезают из tools/list (или их вызовы возвращают понятную ошибку). Прокси продолжает работать и периодически повторяет попытки — он никогда не падает из-за отсутствующего бэкенда.

Related MCP server: ssh-chat-mcp

Использование

# run (stdio; opencode/claude/any MCP client will spawn it):
npx -y github:gbastkowski/mcp-proxy
# or clone + npm install + npm start

Конфигурация (переменные окружения)

Пример: opencode на Macbook с использованием Blender+QGIS на машине akiko

{
  "mcp": {
    "akiko": {
      "type": "local",
      "command": ["npx", "-y", "github:gbastkowski/mcp-proxy"]
    }
  }
}

Запустите MCP_PROXY_HOST=akiko npx -y github:gbastkowski/mcp-proxy — хост берётся из вашего обычного ssh-конфига, ключи — из вашего агента.

Требования

• Node >= 18

• ssh с настроенным алиасом хоста для удалённой машины + рабочая аутентификация по ключам

• На удалённой машине: целевые MCP-серверы, привязанные к 127.0.0.1 (они не доступны из сети; SSH-туннель — единственный мост)

Лицензия

MIT