buda-mcp

Buda.com을 위한 MCP 서버 — 칠레, 콜롬비아, 페루의 선도적인 암호화폐 거래소입니다. MCP 호환 AI 어시스턴트가 시장 데이터, 호가창, 거래 내역, 스프레드, 기술적 지표 및 가격 시뮬레이션에 실시간으로 접근할 수 있게 하며, 계정이나 API 키가 필요하지 않습니다.

빠른 시작

npx @guiie/buda-mcp

또는 영구적으로 설치:

npm install -g @guiie/buda-mcp
buda-mcp

MCP 클라이언트에 설치

Claude Code

claude mcp add buda-mcp -- npx -y @guiie/buda-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "buda-mcp": {
      "command": "npx",
      "args": ["-y", "@guiie/buda-mcp"]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "buda-mcp": {
      "command": "npx",
      "args": ["-y", "@guiie/buda-mcp"]
    }
  }
}

도구

모든 도구는 공개되어 있으며 API 키나 계정이 필요하지 않습니다.

get_market_summary ⭐ 여기서 시작하세요

한 번의 호출로 요약 정보 제공: 최종 가격, 매수/매도 호가, 스프레드 %, 24시간 거래량, 가격 변동 및 liquidity_rating (high / medium / low). 사용자가 특정 시장에 대해 질문할 때 가장 먼저 사용하기 좋은 도구입니다.

get_markets

Buda.com의 모든 거래 쌍을 나열하거나 특정 시장에 대한 세부 정보(수수료, 최소 주문 규모, 할인 등급)를 가져옵니다.

get_ticker

현재 스냅샷: 최종 가격, 최우선 매수/매도 호가, 24시간 거래량, 24시간 및 7일 가격 변동.

get_orderbook

현재 호가창: {price, amount} 객체로 정렬된 매수 및 매도 호가.

get_trades

최근 거래 내역을 유형화된 객체로 제공: {timestamp_ms, amount, price, direction}.

get_market_volume

측면별(매수 = 구매, 매도 = 판매) 24시간 및 7일 거래량.

get_spread

매수/매도 스프레드: 절대값 및 매도 가격 대비 백분율.

compare_markets

주어진 기준 통화에 대해 모든 인용 통화에 걸친 모든 쌍의 티커 데이터를 나란히 비교합니다.

get_price_history

원시 거래 내역에서 집계된 OHLCV 캔들 (Buda는 기본 캔들스틱 엔드포인트가 없습니다). 5m, 15m, 30m, 1h, 4h, 1d 주기를 지원합니다.

get_arbitrage_opportunities

USDC로 정규화된 Buda의 CLP, COP, PEN 시장 전반에 걸쳐 자산의 국가 간 가격 차이를 탐지합니다.

simulate_order

실시간 티커 데이터를 사용하여 매수 또는 매도 주문을 시뮬레이션합니다. 실제 주문은 생성되지 않습니다. estimated_fill_price, fee_amount, total_cost, slippage_vs_mid_pct를 반환합니다. 모든 응답에는 simulation: true가 포함됩니다.

calculate_position_size

자본, 위험 %, 진입가, 손절가를 기반으로 켈리 방식의 포지션 규모를 계산합니다. 완전히 클라이언트 측에서 수행되며 API 호출이 없습니다.

get_market_sentiment

세 가지 구성 요소에서 도출된 복합 심리 점수(-100 ~ +100): 24시간 가격 변동(40%), 7일 평균 대비 거래량(35%), 시장 유형 기준 대비 스프레드(25%). score, label, component_breakdown 및 disclaimer를 반환합니다.

get_technical_indicators

RSI (14), MACD (12/26/9), 볼린저 밴드 (20, 2σ), SMA 20, SMA 50 — Buda 거래 내역에서 서버 측에서 계산됩니다 (외부 라이브러리 없음). 신호 해석과 20개 미만의 캔들을 사용할 수 있는 경우 구조화된 경고를 반환합니다. disclaimer를 포함합니다.

get_real_quotation

주문 생성 없이 특정 주문 금액 및 방향에 대한 실시간 견적을 반환하며, 정확한 체결 가격, 수수료 및 잔액 변화를 보여줍니다.

get_available_banks

특정 통화 국가에서 법정화폐 입출금이 가능한 은행 목록을 나열합니다.

MCP 리소스

도구 외에도 서버는 클라이언트가 직접 읽을 수 있는 MCP 리소스를 노출합니다:

지원되는 시장

소스에서 빌드

git clone https://github.com/gtorreal/buda-mcp.git
cd buda-mcp
npm install
npm run build
node dist/index.js        # stdio (for MCP clients)
node dist/http.js         # HTTP on port 3000 (for Railway / hosted)

테스트 실행:

npm run test:unit        # 100 unit tests, no network required
npm run test:integration # live API tests (skips if unreachable)
npm test                 # both

HTTP / Railway 배포

dist/http.js 진입점은 다음을 포함하는 Express 서버를 실행합니다:

• POST /mcp — 스트리밍 가능한 HTTP MCP 전송

• GET /mcp — SSE 스트리밍 전송

• GET /health — 상태 확인 ({ status })

• GET /.well-known/mcp/server-card.json — Smithery 호환 정적 도구 매니페스트

환경 변수

보안

이 서버는 공개된 Buda.com API 엔드포인트만 노출합니다. 자격 증명은 수락되거나 저장되지 않습니다. 프롬프트 인젝션을 방지하기 위해 모든 도구 매개변수에 입력 유효성 검사가 적용됩니다. 오류 메시지는 정제되며, 내부 세부 정보(경로, 업스트림 오류)는 stderr에만 기록되고 호출자에게 반환되지 않습니다.

취약점 보고

보안 문제는 공개 이슈가 아닌 GitHub 보안 권고를 통해 비공개로 보고해 주십시오. 전체 공개 정책은 SECURITY.md를 참조하십시오.

프로젝트 구조

src/
  client.ts                   BudaClient (HTTP + 429 retry)
  cache.ts                    In-memory TTL cache with in-flight deduplication
  types.ts                    TypeScript types for Buda API responses
  validation.ts               validateMarketId(), validateCurrency()
  utils.ts                    flattenAmount(), aggregateTradesToCandles(), getLiquidityRating()
  version.ts                  Single source of truth for version string
  index.ts                    stdio MCP server entrypoint
  http.ts                     HTTP/SSE MCP server entrypoint
  tools/
    markets.ts                get_markets
    ticker.ts                 get_ticker
    orderbook.ts              get_orderbook
    trades.ts                 get_trades
    volume.ts                 get_market_volume
    spread.ts                 get_spread
    compare_markets.ts        compare_markets
    price_history.ts          get_price_history
    arbitrage.ts              get_arbitrage_opportunities
    market_summary.ts         get_market_summary
    simulate_order.ts         simulate_order
    calculate_position_size.ts calculate_position_size
    market_sentiment.ts       get_market_sentiment
    technical_indicators.ts   get_technical_indicators
    banks.ts                  get_available_banks
    quotation.ts              get_real_quotation
marketplace/
  cursor-mcp.json             Cursor MCP config example
  claude-listing.md           Claude registry listing
  openapi.yaml                OpenAPI spec (GPT Actions / HTTP wrapper)
  gemini-tools.json           Gemini function declarations

라이선스

MIT — Buda.com API 문서