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

BudaのCLP、COP、PEN市場間での資産の国境を越えた価格乖離を検出し、USDCに正規化します。

simulate_order

ライブティッカーデータを使用して買いまたは売り注文をシミュレートします（注文は一切発注されません）。estimated_fill_price、fee_amount、total_cost、slippage_vs_mid_pct を返します。すべてのレスポンスに simulation: true が含まれます。

calculate_position_size

資本、リスク%、エントリー、ストップロスからケリー基準スタイルのポジションサイズを計算します。完全にクライアントサイドで実行され、API呼び出しは行いません。

get_market_sentiment

3つの要素からなる複合センチメントスコア（-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 Advisories を通じて非公開で報告してください。完全な開示ポリシーについては 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 docs