Zebpay MCP Server

프로덕션 준비가 된 TypeScript MCP (Model Context Protocol) 서버로, Zebpay 현물 및 선물 API를 지원하며 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 오류 응답

• 아웃바운드 요청 재시도 및 시간 초과 제어

• 디버깅 및 감사 가능성을 위한 선택적 구조화된 파일 로깅

지원되는 도구

현물 (공개 + 비공개)

• 시장 데이터: 티커, 오더북, 거래, 캔들, 거래소 정보, 통화

• 거래: 시장/지정가 주문, 주문 취소, 심볼별 취소, 전체 취소

• 계정: 잔액, 미체결 주문, 주문 내역, 거래 내역, 거래소 수수료

• 예시 도구 이름:

  • 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 Trading으로 이동하여 Create New API Key를 클릭합니다.

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 탭에서 이슈를 생성하세요.

• <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