gecko-surf

gecko-surf — официальный MCP-сервер от GeckoVision. Превращает спецификацию OpenAPI в инструменты для агентов со скрытой авторизацией. Ставится через npx. Доступен и как удалённый сервер. Лицензия Apache-2.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
GeckoVision
Лицензия
Apache-2.0
Транспорт
stdio, streamable_http
Авторизация
other
ОС
Не указана
Языки
python

Уровень риска: high

Граф знаний API для агентов с симуляцией трат до подписи; размещённый сервер требует ключ Gecko.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"gecko\": {\n      \"url\": \"https://mcp.geckovision.tech/anyquery/mcp\"\n    }\n  }\n}",
    "file": "~/.cursor/mcp.json",
    "lang": "json",
    "verified": "docs"
}

Что умеет

Gecko (пакет gecko-surf) — открытый граф знаний для ИИ-агентов, которые вызывают API. Он запускается на вашей машине: одна команда превращает любое API — запутанное, платное или работающее в блокчейне — в граф вызовов, по которому агент проверяет, а не угадывает, какой вызов сделать. Всё, что тратит деньги, сначала прогоняется в симуляции и возвращает «квитанцию». Источник для Gecko — спецификация OpenAPI, сайт документации или IDL и исходники программы Solana.

Ключевые идеи из README и документации:

  • Происхождение каждого факта. Каждое ребро графа помечено: извлечено из описания, восстановлено из исходников или честно отмечено как неизвестное — без выдумок.
  • Проверка до действия. Действие симулируется на бесплатной копии состояния основной сети Solana: результат — успех или классифицированная ошибка до любой траты.
  • Слежение за изменениями. Результаты вызовов копятся, и Gecko замечает, когда провайдер выпустил изменение, ломающее работающий вызов.
  • Ключи невидимы для агента. Ключ хранится в системной связке ключей (gecko auth set), подставляется в момент вызова и никогда не попадает в mcp.json и в контекст модели.

Gecko не агент и не оркестратор: он не хранит ключей, ничего не подписывает и не рассылает, не хранит ответы API — только описание интерфейса и метаданные корректности. Авторы приводят цифры: 64 транзакции в основной сети, из них для 49 стоимость предсказана до подписи, и 47 предсказаний совпали точно.

Размещённый вариант работает по адресу https://mcp.geckovision.tech/anyquery/mcp: по описанию из официальной конфигурации, он отвечает на вопросы о компаниях, заранее показывает цену и возвращает каждое значение с источником, датой и стоимостью. Отдельный адрес для Solana даёт магазины, платежи и обмены — в виде проверенных неподписанных байтов для вашего собственного подписанта.

Кому подойдёт

Разработчикам агентов, которые работают без присмотра с ключами или деньгами, и тем, кто подключает агентов к плохо документированным или блокчейн-API. Похожие серверы — в категории разработка.

Установка

Без установки: npx @geckovision/gecko doctor, затем add (разбор API без живых вызовов), report (оценка и замечания) и serve (отдача агенту по MCP). Постоянно — npm install -g @geckovision/gecko (готовый бинарник, Python не нужен) или uv tool install "gecko-surf[serve]". Команды serve и SDK по умолчанию работают в режиме записи без обращения к реальному API; живой режим требует ключа и явного --mode live.

Подключение к клиентам

Конфигурации для размещённого сервера — из официального файла mcp-config.json проекта. Подробнее — в инструкции как подключить MCP.

claude mcp add --transport http gecko https://mcp.geckovision.tech/anyquery/mcp

Для Cursor файл — ~/.cursor/mcp.json, для VS Code — .vscode/mcp.json. Этому адресу нужен ключ Gecko: клиент с поддержкой входа откроет страницу, где вы вводите почту и код из письма. Для своего API локально: claude mcp add my-api -- npx -y @geckovision/gecko serve с путём к спецификации и флагом --stdio.

Проверка

Попросите агента вызвать plan_query с простым вопросом: инструмент покажет поля, источники и цену, ничего не тратя.

Примеры задач

Какой сейчас статус привязки USDC к доллару?
Спланируй обмен SOL на USDC на Meteora с bin_step 4.

Как устроена оплата

Платные инструменты сначала называют цену и списывают её только после подтверждения confirm: true. Для покупок в Solana Gecko готовит транзакцию (prepare_purchase), подписывает её ваш кошелёк, затем она проверяется (verify_signed_transaction) и отправляется (submit_transaction). Gecko не является платёжной системой и не держит ключей.

Риски

  • Траты. Платные запросы и покупки в блокчейне — подтверждайте каждую.
  • Живой режим обращается к реальным API с вашими ключами; по умолчанию он выключен.
  • Ключ Gecko храните в окружении или связке ключей, не в чате.

Частые вопросы

Может ли Gecko потратить деньги сам?

Он ничего не подписывает: транзакции подписывает ваш кошелёк, а платные инструменты требуют подтверждения.

Нужен ли ключ?

Для размещённого адреса anyquery — да; локальный разбор и запись работают без ключа.

Где хранятся ключи API?

В системной связке ключей, а не в mcp.json.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

GitHub MCP Server

Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники