Zebpay MCP Server

Zebpayのスポットおよび先物API向けの、本番環境対応のTypeScript製**MCP（Model Context Protocol）**サーバーです。stdioトランスポートのみを使用します。 Model Context Protocol（MCP）は、AIアシスタントがツールやデータソースを安全に呼び出すための標準的な方法です。 Cursor、Claude Desktop、MCP Inspectorなど、ローカルプロセス実行で接続するMCPクライアント向けに設計されています。 このサーバーは、厳格なバリデーション、安全なエラーハンドリング、開発者に優しい可観測性を備え、マーケットデータと取引の両方のワークフローを提供します。

このサーバーが提供するもの

• 公開マーケットデータツール（スポット+先物）

• プライベート取引・アカウントツール（API認証情報が必要）

• エージェントワークフロー向けのMCPリソースとプロンプト

• Zodによるリクエストバリデーション

• 構造化されたエラーハンドリングとオプションのファイルログ出力

Related MCP server: Cashfree MCP Server

特徴

• MCPクライアントとの安全なローカル統合のためのstdio専用MCPサーバー

• 公開操作と認証操作の両方に対応したスポットおよび先物API

• プライベートエンドポイント向けのHMACベースの認証リクエストフロー

• 入力バリデーションと正規化されたMCPエラーレスポンス

• アウトバウンドリクエストのリトライとタイムアウト制御

• デバッグと監査のためのオプションの構造化ファイルログ

対応ツール

スポット（公開+プライベート）

• マーケットデータ: ティッカー、オーダーブック、約定履歴、klines（ローソク足）、取引所情報、通貨

• 取引: 成行/指値注文、注文のキャンセル、シンボル指定でのキャンセル、全件キャンセル

• アカウント: 残高、未約定注文、注文履歴、約定履歴、取引所手数料

• ツール名の例:

  • zebpay_public_getTicker

  • zebpay_public_getOrderBook

  • zebpay_spot_placeMarketOrder

  • zebpay_spot_placeLimitOrder

  • zebpay_spot_getBalance

先物（公開+プライベート）

• マーケットデータ: ヘルスステータス、マーケット、マーケット情報、オーダーブック、24時間ティッカー、集計取引

• 取引/アカウント: ウォレット残高、注文、証拠金の追加/削減、未約定注文、ポジション

• 履歴: 注文履歴、リンク済み注文、約定履歴、取引履歴

• ツール名の例:

  • zebpay_futures_public_getMarkets

  • zebpay_futures_public_getOrderBook

  • zebpay_futures_placeOrder

  • zebpay_futures_getWalletBalance

  • zebpay_futures_getPositions

技術スタック

• Node.js (ESM)

• TypeScript

• @modelcontextprotocol/sdk

• undici

• zod

プロジェクト構成

src/
├── index.ts                  # Stdio MCP server entrypoint
├── mcp/                      # Tools, resources, prompts, MCP errors/logging
├── private/                  # Authenticated Zebpay clients
├── public/                   # Public market-data clients
├── security/                 # Credentials + signing helpers
├── http/                     # Shared outbound HTTP client to Zebpay APIs
├── validation/               # Schemas and validation helpers
├── utils/                    # Caching, metrics, formatting, file logging
└── types/                    # Shared response types

前提条件

• Node.js 20+

• npm 9+

• Zebpay API認証情報（プライベートツール用）

• 公式ZebPay APIポータルからAPIキー/シークレットを作成します: https://api.zebpay.com/

ZebPay APIキーの作成

以下の手順で、このMCPサーバー用のAPI認証情報を生成します:

1. ZebPay APIポータルを開きます: https://api.zebpay.com/

2. ZebPayアカウントにサインインします。

3. API取引に移動し、新しいAPIキーを作成をクリックします。

4. キーの詳細を入力します:

   • キー名（例: zebpay-mcp-local）

   • 必要な権限（マーケット/アカウント確認用の読み取り専用、必要な場合のみ取引権限）

   • オプションのIPホワイトリスト（セキュリティ向上のため推奨）

5. OTP認証を完了します。

6. 以下をコピーして保存します:

   • APIキー

   • シークレットキー（一度だけ表示されます）

次に、ローカルの.envファイルに追加します:

ZEBPAY_API_KEY=your_api_key
ZEBPAY_API_SECRET=your_api_secret

セキュリティに関する注意:

• APIキー/シークレットをgitにコミットしないでください。

• API権限は最小権限を推奨します。

• キーが漏洩した場合はすぐにローテーションしてください。

セットアップ

git clone <your-repo-url>
cd zebpay-mcp-server
npm install
cp env.example .env

.envを更新します（すべての値は環境変数から読み取られます。コード内にフォールバックのデフォルト値はありません）:

ZEBPAY_API_KEY=your_api_key    # Use the API key from the step above
ZEBPAY_API_SECRET=your_api_secret    # Use the Secret key from the step above
ZEBPAY_SPOT_BASE_URL=https://sapi.zebpay.com/api/v2
ZEBPAY_FUTURES_BASE_URL=https://futuresbe.zebpay.com/api/v1
ZEBPAY_MARKET_BASE_URL=https://www.zebapi.com/api/v1/market
MCP_TRANSPORTS=stdio
LOG_LEVEL=info
HTTP_TIMEOUT_MS=15000
HTTP_RETRY_COUNT=2

ビルドと実行

npm run build
npm start

オプションのファイルログ出力:

npm run start:log

MCPクライアント設定（Stdio）

MCPクライアント設定の例:

{
  "mcpServers": {
    "zebpay": {
      "command": "node",
      "args": [
          "/absolute/path/to/zebpay-mcp-server/dist/index.js"
        ],
      "env": {
        "ZEBPAY_API_KEY": "YOUR_API_KEY_HERE",
        "ZEBPAY_API_SECRET": "YOUR_API_SECRET_HERE",
        "LOG_LEVEL": "info"
      }
    }
  }
}

関連情報: mcp-config.json.example も参照してください。

環境変数

開発者コマンド

npm run build
npm test
npm run test:watch
npm run logs
npm run logs:watch
npm run logs:errors
npm run logs:stats
npm run logs:clear

ロギング

• ログツールと例: scripts/README.md

• ロギングの完全なドキュメント: docs/LOGGING.md

• ログをgitに含めない（logs/は無視されます）

問題報告

バグを発見した場合や機能リクエストをしたい場合:

• このリポジトリのGitHub Issuesタブからissueを作成してください。

• <your-org>と<your-repo>を置き換えた後、直接リンクも使用できます:

  • バグ報告: https://github.com/<your-org>/<your-repo>/issues/new?template=bug_report.md

  • 機能リクエスト: https://github.com/<your-org>/<your-repo>/issues/new?template=feature_request.md

• 迅速なトリアージのために以下の詳細を含めてください:

  • 使用したMCPクライアント（Cursor/Claude Desktop/その他）

  • Node.jsのバージョンとOS

  • 最小限の再現手順

  • 関連するログ（シークレットは伏せ字にしてください）

ライセンス

MIT