Skip to content

Commit 67828f5

Browse files
DreDvilclaude
andcommitted
fix(kit): дефолтный транспорт SSE — opencode remote MCP умеет только SSE
Переключение на Streamable HTTP было ошибкой: opencode remote MCP клиент поддерживает только SSE (anomalyco/opencode#8058), из-за чего /mcp давал 'sse error: Non-200 status code (404)'. Настоящий фикс исходного -32602 — это 'timeout': 600000 в opencode.json (дефолт 5000мс рвал initialize-хендшейк, отсюда каскад 'before initialization'). - server.py: TRANSPORT дефолт http -> sse (env TRANSPORT=http оставлен для /mcp) - opencode.json: kit url /mcp -> /sse (timeout сохранён) - README: транспорт/эндпоинт/env синхронизированы Co-Authored-By: Claude Opus 4.8 <[email protected]>
1 parent 47ce764 commit 67828f5

3 files changed

Lines changed: 16 additions & 14 deletions

File tree

‎pentest-agents/opencode.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@
2828
},
2929
"kit": {
3030
"type": "remote",
31-
"url": "http://127.0.0.1:8731/mcp",
31+
"url": "http://127.0.0.1:8731/sse",
3232
"enabled": true,
3333
"timeout": 600000
3434
}

‎tool-runner/README.md‎

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,9 @@
55
live-хосты, JS-краул) и **браузер Playwright** (DOM/SPA). Плюс — **PDF-рендер** отчёта
66
и **человеко-визируемый sandbox** для разработки PoC.
77

8-
opencode подключает его как `type: remote` по **Streamable HTTP** (эндпоинт `/mcp`), так же как Burp.
9-
Транспорт переключаем env `TRANSPORT` (`http` по умолчанию / `sse` для легаси).
8+
opencode подключает его как `type: remote` по **SSE** (эндпоинт `/sse`) — opencode remote MCP умеет только SSE.
9+
Транспорт: env `TRANSPORT` (`sse` по умолчанию / `http` — Streamable HTTP `/mcp`, для клиентов, которые его умеют).
10+
Долгим сканерам обязателен `"timeout": 600000` в `opencode.json` (дефолт 5000 мс рвёт вызовы — корень `-32602`).
1011

1112
> ⚖️ **Scope — жёсткая граница.** Каждый инструмент, принимающий цель, СНАЧАЛА сверяет
1213
> её со `scope.txt` (см. `scope.py`) — вне scope запрос отклоняется, а не выполняется.
@@ -49,8 +50,8 @@ docker run --rm -p 8731:8731 \
4950
-v "$(pwd)/../pentest-agents/scope.txt:/scope/scope.txt:ro" \
5051
--name kit pentesthelper-kit
5152
```
52-
Проверка: в логах контейнера должно быть `[kit] tool-runner MCP (http) on http://0.0.0.0:8731/mcp`.
53-
opencode подключается к `/mcp` (Streamable HTTP). Для легаси-SSE запусти с `-e TRANSPORT=sse` (эндпоинт `/sse`).
53+
Проверка: в логах контейнера должно быть `[kit] tool-runner MCP (sse) on http://0.0.0.0:8731/sse`.
54+
opencode подключается к `/sse`. Клиент со Streamable HTTP — запусти с `-e TRANSPORT=http` (эндпоинт `/mcp`).
5455

5556
> Базовый образ — `golang:1.25-bookworm`: последние ProjectDiscovery-инструменты требуют Go ≥ 1.25.7. Тулчейн стоит на `GOTOOLCHAIN=auto`, так что при необходимости Go подтянет более новый сам.
5657
@@ -87,18 +88,18 @@ connect-scan, поэтому `--cap-add` не нужен.
8788

8889
В `pentest-agents/opencode.json` (уже добавлено) есть второй MCP-сервер:
8990
```jsonc
90-
"kit": { "type": "remote", "url": "http://<docker-host>:8731/mcp", "enabled": true, "timeout": 600000 }
91+
"kit": { "type": "remote", "url": "http://<docker-host>:8731/sse", "enabled": true, "timeout": 600000 }
9192
```
9293
Замените `<docker-host>` на адрес хоста с контейнером (для Windows+WSL — IP WSL или
9394
проброшенный порт). `timeout: 600000` обязателен: дефолт opencode 5000 мс рвёт долгие
94-
сканеры (httpx/nuclei) на полпути. Эндпоинт — `/mcp` (Streamable HTTP); `/sse` — только при `TRANSPORT=sse`.
95+
сканеры (httpx/nuclei) на полпути. Эндпоинт — `/sse` (SSE, дефолт; opencode умеет только его); `/mcp` — при `TRANSPORT=http`.
9596

9697
## Переменные окружения
9798

9899
| Env | Дефолт | Смысл |
99100
|---|---|---|
100101
| `HOST` / `PORT` | `0.0.0.0` / `8731` | адрес MCP-сервера |
101-
| `TRANSPORT` | `http` | транспорт: `http` (Streamable HTTP, `/mcp`) или `sse` (легаси, `/sse`) |
102+
| `TRANSPORT` | `sse` | транспорт: `sse` (`/sse`, дефолт — opencode remote умеет только его) или `http` (Streamable HTTP, `/mcp`) |
102103
| `SCOPE_FILE` | `/scope/scope.txt` | файл scope (монтируется) |
103104
| `SCOPE` | — | scope через env (через запятую), в дополнение к файлу |
104105
| `WORDLIST` | `/app/wordlists/common.txt` | словарь по умолчанию для ffuf |

‎tool-runner/server.py‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
#!/usr/bin/env python3
22
"""tool-runner — the PentestHelper Docker arsenal, exposed to opencode over MCP (SSE).
33
4-
opencode connects to this over Streamable HTTP, like it connects to Burp:
5-
"kit": { "type": "remote", "url": "http://<docker-host>:8731/mcp", "enabled": true, "timeout": 600000 }
4+
opencode connects to this over SSE (opencode remote MCP is SSE-only), like Burp:
5+
"kit": { "type": "remote", "url": "http://<docker-host>:8731/sse", "enabled": true, "timeout": 600000 }
66
77
Tools appear to agents as kit_run_nuclei, kit_run_httpx, kit_render_page, ...
88
@@ -32,10 +32,11 @@
3232
# Каталог шаблонов nuclei, запечённый в образ на этапе сборки (см. Dockerfile).
3333
# Передаём его в nuclei -templates-directory, чтобы детект работал офлайн, без git/сети.
3434
NUCLEI_TEMPLATES_DIR = os.environ.get("NUCLEI_TEMPLATES_DIR", "/opt/nuclei-templates")
35-
# Транспорт: "http" (Streamable HTTP, stateless — рекомендуется, так же opencode
36-
# говорит с Burp) или "sse" (легаси: пер-сессионный initialize-хендшейк, хрупкий
37-
# с частью клиентов — отсюда "Received request before initialization was complete").
38-
TRANSPORT = os.environ.get("TRANSPORT", "http").lower()
35+
# Транспорт: "sse" (эндпоинт /sse) — ДЕФОЛТ, т.к. opencode remote MCP умеет ТОЛЬКО SSE;
36+
# или "http" (Streamable HTTP, /mcp) — для клиентов, которые его поддерживают.
37+
# ВАЖНО: долгие сканеры требуют "timeout": 600000 в opencode.json (дефолт 5000 мс рвёт
38+
# вызовы вне зависимости от транспорта — это и был корень -32602/"before initialization").
39+
TRANSPORT = os.environ.get("TRANSPORT", "sse").lower()
3940

4041
# stateless_http убирает пер-сессионную инициализацию (каждый POST самодостаточен) —
4142
# безопасно, т.к. наши инструменты не хранят состояние между вызовами.

0 commit comments

Comments
 (0)