trippy-mcp

코딩 에이전트가 Injective에서 거래할 수 있게 해주세요. trippy-mcp는 Claude Code, Codex, Cursor(모든 MCP 클라이언트)에 연결되어 다음과 같은 도구를 제공하는 stdio MCP 서버입니다:

• 토큰 발행 - SHROOM Pad에서 (본딩 커브 → Choice CLMM 풀로 졸업)

• 본딩 커브 토큰 거래 - (매수/매도/견적, 온체인 정확 견적)

• 모든 Injective 토큰 스왑 - Choice 집계 라우터를 통해 (AMM + CLMM + 오더북 스마트 오더 라우팅)

• 에이전트 신원 보유 - 에이전트의 거래는 Trippy Terminal에서 AGENT 배지를 획득하며, 선택적으로 프로필에 연결 가능

비수탁형 구조. 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에서 트렌딩은 뭐야? 상위 1위에 대해 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

보안 모델

키는 절대 사용자 머신을 떠나지 않으며, 오작동하는(또는 프롬프트 인젝션된) 모델과 사용자 자금 사이에는 4개의 독립적인 보안 계층이 있습니다:

1. 예산 설정 버너 지갑 - 지갑에는 사용자가 보낸 금액만 보관됩니다. 메인 지갑은 절대 접근되지 않습니다.

2. 서명자의 정책 엔진 (도구나 모델이 아닌): 거래당 USD 상한, 24시간 롤링 예산, 슬리피지 상한, 하드 계약 허용 목록(LaunchpadCore, 견적 자산, Choice 집계기, 클레임 드롭 계약 - 그 외 없음). ~/.trippy-mcp/config.json에서 설정 가능하며, 변경은 사람의 작업입니다.

3. 스위프는 단방향 귀환 - sweep은 대상을 받지 않습니다. 자금은 init에서 설정한 소유자 주소로만 이동할 수 있습니다. 에어드롭은 사용자가 지정하지 않은 주소로 가치를 보내는 유일한 예외이므로, 자체 상한(airdropCapUsd, 거래 상한과 별도)이 있으며, USD 평가를 건너뛸 수 없고, 원시 기준 대신 미리 본 플랜 ID가 필요합니다.

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 서버를 제공하며, 두 서버는 함께 실행되도록 설계되었습니다. 이름이 충돌하지 않고 역할이 명확하게 분리됩니다:

두 서버는 서로 다른 지갑에 서명합니다. Injective MCP의 wallet_generate / wallet_import는 ~/.injective-agent/keys/에 기록하며, 해당 주소로는 여기서 거래할 수 없습니다. 해당 키스토어가 존재하면 wallet_status와 agent_info가 otherAgentWallets로 이를 보고하므로, 모델이 혼란스러운 0 잔고 대신 명확히 알릴 수 있습니다.

그 상태를 유지하세요. 의도된 조합은 자금 순환 루프입니다. 즉, 자신의 지갑(Injective MCP의 transfer_send로 가능)에서 이 에이전트로 자금을 조달하고, 수익을 sweep으로 다시 보내는 것입니다. 공유 키가 아닙니다. Injective MCP 서버는 지출 정책 없이 서명하며 키스토어 비밀번호를 도구 인수로 받기 때문에, 이 에이전트의 키를 가져오면 거래당 한도, 일일 예산, 고정된 스위프 대상이 한 번에 무효화됩니다.

모든 위 내용을 에이전트에게 가르치는 스킬이 있습니다:

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

에이전트 신원

init은 에이전트 이름을 Trippy 레지스트리에 등록합니다(에이전트 키로 서명 — 키 제어 증명이며, 수탁적이지 않음). 이후 해당 에이전트의 거래는 Trippy Terminal에 AGENT 배지가 표시됩니다. 이 에이전트를 프로필에 연결하려면("귀하가 운영함"), trippy-mcp claim-code를 실행하고 Terminal → Settings → Agents에서 귀하의 메인 지갑으로 코드를 입력하세요.

--avatar 플래그로 에이전트에 프로필 이미지를 부여하세요(init 시 또는 이후 register에서): https URL 또는 로컬 .png/.jpg/.webp/.gif 파일을 전달하세요. 로컬 파일은 SHROOM API를 통해 IPFS에 업로드됩니다. 이미지는 Terminal이 에이전트 주소의 프로필 아바타를 표시하는 모든 곳에 나타납니다. --avatar 없이 재등록하면 현재 이미지가 유지됩니다. 에이전트가 클레임되면 이름과 아바타는 CLI 없이 Terminal → Settings → Agents에서 편집할 수도 있습니다.

온체인 신원 (ERC-8004)

위 레지스트리는 Trippy의 레지스트리입니다. Injective에는 생태계 차원의 온체인 레지스트리도 있습니다: ERC-8004 신원 NFT와 그 뒤의 평판 레지스트리로, 메인넷에서 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432에 있습니다. 이를 발행하면 에이전트가 이 터미널 너머에서도 검색 가능해지며, 레지스트리가 배포된 모든 체인으로 이식 가능해집니다. 비용은 한 번의 트랜잭션, 즉 1센트의 극히 일부입니다.

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초 이상의 마감을 거부하므로, 이 서명은 설계상 약 4분 동안만 유효하며, 명령을 다시 실행하는 것은 무료입니다.

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 특이사항

• Injective의 EVM RPC에서 eth_getBalance가 자금이 있는 계정에 대해 0을 보고할 수 있습니다. 잔고는 Cosmos 뱅크(LCD)에서 읽으며, 전송 shim이 viem의 사전 점검을 정직하게 유지합니다. 탐색기/MetaMask는 에이전트 지갑에 대해 0을 표시할 수 있습니다. trippy-mcp status가 권위 있는 정보를 제공합니다.

• 가스는 사용량이 아닌 한도로 청구됩니다. 서명기는 평평한 한도 대신 예상치에 약간의 버퍼를 추가하여 추정합니다.

• 공용 RPC는 간헐적으로 502 오류를 반환하고 영수증이 지연됩니다. 요청은 엔드포인트 간에 재시도되며, 영수증이 없으면 잘못된 실패 대신 상태를 다시 읽도록 트리거됩니다.

• 런치는 keeper가 바인딩할 때까지(~초) 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

릴리스는 v* 태그에서 CI를 통해 게시됩니다(npm 신뢰 게시 via OIDC, 따라서 토큰이 없고 출처가 자동으로 기록됨). 버전을 올리고, 태그를 만들고, 푸시하세요.

설계 및 테스트 노트:

• docs/DESIGN-protocol-docs-and-airdrops.md — explain과 에어드롭 레일이 현재 형태를 갖춘 이유, 구축 과정에서 내린 결정, 그리고 체인에 대해 처음 실행한 전체 레일 스윕(코드가 믿었으나 체인이 반박한 다섯 가지 사항 포함)

• docs/TESTING-airdrops.md — 실제 설치를 건드리지 않고 테스트넷에서 레일을 실행하는 방법, 그리고 아직 테스트되지 않은 사항

MIT