surf — MCP-сервер для Claude Code: граф вызовов API вместо догадок
Превращает OpenAPI-спеку или IDL Solana-программы в граф, по которому агент проверяет вызов до отправки. Полезно там, где ошибка стоит денег.
claude mcp add --transport http surf https://mcp.geckovision.tech/mcpЧто делает surf
surf читает описание API и строит по нему граф: каждый факт помечен, откуда он взялся — вытащен из описания, восстановлен из исходников или честно помечен как неизвестный. Агент ходит по этому графу, а не сочиняет параметры. Для вызовов, которые тратят деньги, сервер сначала прогоняет их в симуляции и отдаёт расписку: пройдёт или отвалится с конкретной ошибкой.
Ключи провайдеров лежат в связке ключей ОС и подставляются в момент вызова. Модель учётных данных не видит, в mcp.json они тоже не попадают. Сервер ничего не подписывает и не отправляет в сеть, ответы API не хранит — только описания и метаданные о корректности.
Подключение к Claude идёт одной командой, вариантов два: удалённый эндпоинт https://mcp.geckovision.tech/mcp или локальный запуск через uvx gecko-surf. Второй способ требует uv. Авторизацию включают отдельным шагом, уже после подключения: без неё агент упрётся в платный вызов и получит отказ.
Какие задачи решает
- получить один конкретный вызов API вместо выдуманных агентом параметров
- проверить платную транзакцию Solana до подписи и увидеть расписку
- подставить ключ провайдера, не показывая его модели
- поймать дрейф: провайдер поменял API и рабочий вызов сломался
- разметить в графе факты, которых нет в спеке
Примеры запросов агенту
- Покажи текущее состояние привязки USDC к доллару
- Собери план обмена SOL на USDC в Meteora с bin_step 4
- Какие матчи начнутся в ближайший час и какие сейчас коэффициенты?
Как установить surf
1Командой платформы: удалённый сервер
claude mcp add --transport http surf https://mcp.geckovision.tech/mcp2Командой платформы
claude mcp add surf -- uvx gecko-surfuvx запускает команду с именем пакета; если в README она другая — uvx --from gecko-surf <команда>
1Командой платформы: удалённый сервер
codex mcp add surf --url https://mcp.geckovision.tech/mcp2Командой платформы
codex mcp add surf -- uvx gecko-surfuvx запускает команду с именем пакета; если в README она другая — uvx --from gecko-surf <команда>
Файл настроек
{
"mcpServers": {
"surf": {
"url": "https://mcp.geckovision.tech/mcp"
}
}
}{
"mcpServers": {
"surf": {
"command": "uvx",
"args": [
"gecko-surf"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from gecko-surf <команда>
Файл настроек
{
"servers": {
"surf": {
"type": "http",
"url": "https://mcp.geckovision.tech/mcp"
}
}
}{
"servers": {
"surf": {
"type": "stdio",
"command": "uvx",
"args": [
"gecko-surf"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from gecko-surf <команда>
1Командой платформы: удалённый сервер
gemini mcp add -t http surf https://mcp.geckovision.tech/mcp2Командой платформы
gemini mcp add surf uvx gecko-surfuvx запускает команду с именем пакета; если в README она другая — uvx --from gecko-surf <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о surf
Как установить surf в Claude Code?
Через удалённый сервер: claude mcp add --transport http surf https://mcp.geckovision.tech/mcp. Либо локально: claude mcp add surf -- uvx gecko-surf — для этого нужен uv.
Что делает surf?
Строит граф знаний по OpenAPI-спеке, документации или IDL Solana-программы. Агент проверяет по нему вызов перед отправкой, а тратящие операции прогоняются в симуляции.
Нужно ли отдавать серверу ключи API?
Ключ кладут в связку ключей ОС командой gecko auth set <provider>. Подстановка идёт при вызове, сам ключ в конфигурации MCP-клиента не хранится.
