trippy-mcp

Позвольте вашему агенту кода торговать на Injective. trippy-mcp — это stdio MCP сервер, который подключается к Claude Code, Codex, Cursor (любому MCP-клиенту) и предоставляет ему инструменты для:

• запуска токенов на SHROOM Pad (кривая связывания → выпуск в пул Choice CLMM)

• торговли токенами на кривой связывания (покупка/продажа/котировка, точные ончейн-котировки)

• обмена любого токена Injective через маршрутизатор агрегации Choice (AMM + CLMM + умная маршрутизация ордербука)

• наличия идентичности агента: сделки вашего агента получают значок AGENT на Trippy Terminal, опционально привязанный к вашему профилю

Некастодиальный по построению. init генерирует новый ключ на вашей машине; сервер никогда его не видит. Кошелек агента — это бюджетный сжигатель, который вы пополняете с основного кошелька — никогда не используя основной ключ.

Быстрый старт

npx trippy-mcp init      # generate the agent wallet, pick a name, register,
                         # and wire up every coding agent found on this machine
# then fund the printed address with a small INJ budget

Затем просто поговорите с вашим агентом: «что в тренде на shroom pad? дай котировку на покупку 0.5 INJ по топовому» — или «запусти токен с названием ... с этим логотипом».

init записывает запись MCP за вас. Чтобы добавить больше клиентов позже или подключить репозиторий:

trippy-mcp connect --client claude,codex,cursor,windsurf   # or --client all
trippy-mcp connect --scope project                         # writes ./.mcp.json
trippy-mcp connect --print                                 # just show the snippets

Записи выполняются слиянием с переименованием, при этом сохраняется копия .trippy-bak, так что ничего другого в ~/.claude.json (или вашем Codex TOML, включая комментарии) не нарушается. Пароль хранилища ключей встраивается только в файлы пользовательской области, chmod 0600 — конфигурация проекта попадает в git, поэтому она опускается с примечанием.

Related MCP server: cook4fun-mcp

Модель безопасности

Ключ никогда не покидает вашу машину, и четыре независимых уровня стоят между неправильно работающей (или подвергшейся инъекции промпта) моделью и вашими средствами:

1. Бюджетный сжигатель — кошелек содержит только то, что вы ему отправляете. Ваш основной кошелек никогда не затрагивается.

2. Движок политик в подписанте (не в инструментах, не в модели): лимит USD на транзакцию, скользящий 24-часовой бюджет, максимальное проскальзывание и жесткий белый список контрактов (LaunchpadCore, его активы котировки, агрегатор Choice, контракт claim-drops — ничего больше). Настраивается в ~/.trippy-mcp/config.json; изменение — это действие человека.

3. Sweep — односторонний перевод домой — sweep не принимает адрес назначения. Средства могут идти только на адрес владельца, который вы указали при init. Единственное исключение — airdrop, который отправляет ценность на адреса, которые вы не называли, поэтому у них есть свой собственный лимит (airdropCapUsd, отдельный от торгового лимита), им никогда не разрешается пропускать оценку в USD, и они требуют предварительно просмотренного идентификатора плана, а не сырых критериев.

4. Дисциплина недоверенных данных — названия/описания токенов — это интернет-текст, контролируемый атакующим; инструменты очищают их и помещают под untrusted_metadata, чтобы ваш агент обрабатывал их как данные, а не как инструкции.

Плюс: зашифрованное хранилище ключей по умолчанию (scrypt + AES-256-GCM), журнал аудита только для добавления (~/.trippy-mcp/audit.log), режим dryRun и аварийный выключатель tradingEnabled. export-key существует, но кричит на вас.

Инструменты

buy/sell/quote/portfolio/sweep указывают свою область действия в описаниях, поэтому модель, к которой также подключен Injective MCP, выбирает правильный сервер (и правильный кошелек) — см. ниже.

Имена инструментов — это чистые глаголы. Claude Code добавляет для вас пространство имен (mcp__trippy__buy); в средах, показывающих плоский список, установите TRIPPY_MCP_TOOL_PREFIX=trippy в окружении сервера, чтобы зарегистрировать trippy_buy, trippy_sell и так далее.

Вместе с Injective AI SDK

@injectivelabs/ainj поставляется со своим собственным MCP-сервером, и эти два сервера предназначены для совместной работы — имена не конфликтуют, а разделение четкое:

Они подписывают для разных кошельков. wallet_generate / wallet_import Injective MCP записывают в ~/.injective-agent/keys/; эти адреса не могут здесь торговать. Когда это хранилище ключей присутствует, wallet_status и agent_info сообщают о нем в otherAgentWallets, чтобы модель говорила об этом вслух, а не сообщала сбивающий с толку ноль.

Пусть так и остается. Предполагаемое сочетание — это цикл финансирования: пополняйте этого агента со своего кошелька (transfer_send Injective MCP отлично работает), sweep прибыль обратно — а не общий ключ. Этот сервер подписывает без политики расходов и принимает пароль от хранилища ключей как аргумент инструмента, поэтому импорт ключа этого агента в него аннулирует лимит на транзакцию, дневной бюджет и фиксированное назначение sweep за один раз.

Существует навык, который обучает агента всему вышеперечисленному:

npx skills add danvaneijck/trippy-mcp --skill injective-memecoin-trading

Идентичность агента

init регистрирует имя вашего агента в реестре Trippy (подписано ключом агента — доказательство контроля ключа, ничего кастодиального). После этого его сделки показывают значок AGENT в Trippy Terminal. Чтобы привязать его к своему профилю («управляется вами»), выполните trippy-mcp claim-code и введите код в Terminal → Settings → Agents с вашим основным кошельком.

Задайте агенту изображение профиля с помощью --avatar (при init или любом последующем register): укажите https URL или локальный .png/.jpg/.webp/.gif — локальные файлы загружаются в IPFS через SHROOM API. Изображение отображается везде, где Terminal показывает аватары профиля для адреса агента. Повторная регистрация без --avatar сохраняет текущее изображение. После того как агент заявлен, его имя и аватар также можно редактировать из Terminal → Settings → Agents без CLI-цикла.

Идентичность в цепочке (ERC-8004)

Реестр выше принадлежит Trippy. У Injective также есть общеэкосистемный реестр в цепочке: ERC-8004 — NFT идентичности с реестром репутации за ними, по адресу 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 в мейннете. Чеканка одного делает вашего агента обнаруживаемым за пределами этого терминала и переносимым на каждую цепочку, где развернут этот реестр. Это стоит одну транзакцию, долю цента.

trippy-mcp identity register        mint the identity (one tx)
trippy-mcp identity show            read it back from the chain
trippy-mcp identity transfer --yes  hand it to your owner wallet
trippy-mcp identity link            sign the wallet link your wallet submits

register оставляет агенту владение его собственной идентичностью. Перемещение ее к вам — это то, что не позволяет скомпрометированному ключу агента забрать идентичность с собой, и порядок важен:

1. identity transfer --yes отправляет NFT на адрес владельца, зафиксированный при init. Это очищает указатель реестра обратно на агента, поэтому его сделки перестают приписываться идентичности до шага 3.

2. identity link подписывает сообщение, авторизующее ваш кошелек для перенаправления. Реестр отклоняет любой срок более 300 секунд, поэтому эта подпись живет около четырех минут по замыслу, и повторный запуск команды бесплатен.

3. В Terminal → Settings → Agents нажмите Complete on-chain link. Это реальная транзакция с вашего кошелька, поэтому она стоит газа. Если таймер истек, запустите identity link снова.

agent_info сообщает идентичность и то, какая сторона владеет кастодией, чтобы агент мог сам вам рассказать, а также свою страницу на 8004scan.

CLI

trippy-mcp init          create wallet + identity, then connect detected clients
                         (interactive; --plaintext, --network testnet, --avatar <url|path>, --no-connect)
trippy-mcp serve         run the MCP server (this is what your agent client launches)
trippy-mcp connect       write the MCP entry into your coding agent's config
                         (--client claude|codex|cursor|windsurf|all, --scope user|project,
                          --name <server-name>, --no-passphrase, --print)
trippy-mcp status        balances (bank-authoritative), policy budget, registration
trippy-mcp register      re-register / rename; --avatar <url|path> sets the profile image
trippy-mcp claim-code    mint a profile-link code
trippy-mcp identity <register|show|link|transfer>
                         the agent's ERC-8004 on-chain identity
trippy-mcp sweep <asset> <amount|all>
trippy-mcp export-key --yes-i-understand

Конфигурация (~/.trippy-mcp/config.json)

{
  "network": "mainnet",
  "agentName": "my-agent",
  "ownerSweepAddress": "0x…",        // immutable — the only sweep destination
  "policy": {
    "perTxCapUsd": 200,
    "dailyBudgetUsd": 1000,
    "maxSlippageBps": 300,
    "tradingEnabled": true,
    "allowUnpricedSpend": false,      // permit spends with no USD price; each one is charged
                                     // perTxCapUsd against the 24h budget, since an unpriced
                                     // spend that counted as $0 would bypass the budget entirely
    "airdropCapUsd": 1000            // max USD per airdrop campaign; 0 = airdrop tools not
                                     // registered at all — including `airdrop_manage`, so wind
                                     // down any live campaign before switching them off
  },
  "dryRun": false,
  "cw20Tokens": []                   // extra CW20 contracts `portfolio` should probe, on top of
                                     // the built-ins (SHROOM, dINJ, NONJA, hINJ, DOJO, COKE,
                                     // Pedro). A CW20 balance is not bank state and cannot be
                                     // enumerated from the chain, so a holding is only visible
                                     // if its contract is known up front — `quote`/`sell` handle
                                     // any CW20 fine, but `portfolio` can only show these
  // optional: rpcUrls, lcdUrl, pumpApiBase, choiceApiBase, gasBufferPct, gasPriceWei, referrer
}

Особенности Injective, которые этот пакет обрабатывает за вас

• eth_getBalance может сообщать 0 для профинансированных аккаунтов на EVM RPC Injective — балансы читаются из банка Cosmos (LCD), и транспортная прослойка сохраняет честность предварительной проверки viem. Обозреватели/MetaMask могут показывать 0 для кошелька агента; trippy-mcp status является авторитетным.

• Газ оплачивается по лимиту, а не по использованию — подписывающий оценивает и добавляет небольшой буфер вместо фиксированных лимитов.

• Публичные RPC периодически выдают 502, а квитанции задерживаются — запросы повторяются через разные конечные точки, а отсутствие квитанции вызывает повторное чтение состояния вместо ложной ошибки.

• Запуски начинаются как Reserved, пока хранитель не свяжет их (~секунды): create_token ждет и сообщает честно.

Разработка

npm ci && npm run typecheck && npm test && npm run build
node scripts/sync-abi.mjs --check     # ABI-drift guard against the vendored artifact
SHROOM_REPO=../shroom_launchpad node scripts/sync-abi.mjs --refresh

Релизы публикуются из CI по тегу v* (доверенная публикация npm через OIDC, поэтому нет токена, а происхождение автоматическое) — увеличьте версию, создайте тег, отправьте.

Заметки по дизайну и тестированию:

• docs/DESIGN-protocol-docs-and-airdrops.md — почему explain и рельсы для эйрдропов имеют такую форму, решения, принятые при их создании, и полный прогон по рельсам, который впервые запустил их против цепочки (включая пять вещей, в которые код верил, но цепочка опровергла).

• docs/TESTING-airdrops.md — как опробовать рельсы на тестнете, не трогая живую установку, и что еще не протестировано.

MIT