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.
Настройка клиентов
{
"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 для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.