MCP Paradex 서버

Paradex 거래 플랫폼을 위한 MCP(Model Context Protocol) 서버 구현.

개요

이 프로젝트는 클로드와 같은 AI 비서와 파라덱스(Paradex)의 영구 선물 거래 플랫폼을 연결하는 다리 역할을 합니다. MCP 표준을 사용하여 AI 비서는 다음과 같은 작업을 수행할 수 있습니다.

• Paradex에서 시장 데이터 검색

• 거래 계좌 및 금고 관리

• 주문하기 및 관리하기

• 위치와 균형을 모니터링하세요

필수 조건

• 파이썬 3.10+

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 mcp-paradex-py를 자동으로 설치하려면:

지엑스피1

uv 사용(더 빠른 대안)

1. 이 저장소를 복제하세요:

   git clone https://github.com/sv/mcp-paradex-py.git cd mcp-paradex-py

2. 가상 환경 만들기:

   uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate

3. 종속성 설치:

구성

구성을 설정하세요:

그런 다음 Paradex 자격 증명으로 .env 파일을 편집합니다.

서버 실행

Docker(권장)

커서에 MCP를 명령으로 추가합니다.

공개 전용

거래 허용

Smithery.ai 통합

이 MCP 서버는 MCP 서버를 검색하고 배포하는 플랫폼인 Smithery.ai 와 호환됩니다.

클로드 데스크톱 구성

Smithery.ai를 통해 Claude Desktop과 함께 이 서버를 사용하려면:

1. Claude Desktop을 열고 메뉴에서 개발자 모드를 활성화하세요.

2. 설정 > 개발자로 이동하여 "구성 편집"을 클릭하세요.

3. claude_desktop_config.json 에 다음 구성을 추가하세요.

4. your_ethereum_private_key 실제 Paradex 개인 키로 바꾸세요.

5. 파일을 저장하고 Claude Desktop을 다시 시작하세요.

Smithery.ai 레지스트리

서버에는 Smithery.ai 레지스트리의 메타데이터가 포함된 smithery.yaml 파일이 포함되어 있습니다. 이 서버를 Smithery.ai에 게시하려면 Smithery CLI를 사용할 수 있습니다.

Smithery.ai에 게시하는 방법에 대한 자세한 내용은 Smithery 설명서를 참조하세요.

사용 가능한 리소스 및 도구

자원

시스템 리소스

• paradex://system/config - Paradex 시스템 구성 및 거래소에 대한 기본 정보를 가져옵니다.

• paradex://system/time - epoch 이후 현재 시스템 시간을 밀리초 단위로 가져옵니다.

• paradex://system/state - 현재 Paradex 시스템 운영 상태를 가져옵니다.

시장 자원

• paradex://markets - Paradex에서 사용 가능한 시장 목록을 가져옵니다.

• paradex://market/summary/{market_id} - 특정 거래 쌍에 대한 자세한 시장 정보를 얻습니다.

볼트 리소스

• paradex://vaults - Paradex에서 사용 가능한 모든 볼트를 나열합니다.

• paradex://vaults/config - 볼트에 대한 글로벌 구성 가져오기

• paradex://vaults/balance/{vault_id} - 특정 볼트의 잔액을 가져옵니다.

• paradex://vaults/summary/{vault_id} - 볼트에 대한 포괄적인 요약을 받으세요

• paradex://vaults/transfers/{vault_id} - 금고의 입금 및 출금 내역을 가져옵니다.

• paradex://vaults/positions/{vault_id} - 볼트의 현재 거래 포지션을 가져옵니다.

• paradex://vaults/account-summary/{vault_id} - 볼트에 대한 거래 계좌 정보를 가져옵니다.

도구

시스템 도구

• paradex_system_config - 글로벌 Paradex 시스템 구성 가져오기

• paradex_system_state - 현재 시스템 상태 가져오기

마켓 도구

• paradex_markets - 기준/견적 자산, 틱 크기 및 기타 거래 매개변수를 포함한 시장에 대한 자세한 정보를 얻으세요.

• paradex_market_summaries - 가격, 거래량, 24시간 변화 및 기타 주요 시장 지표에 대한 요약을 받아보세요.

• paradex_funding_data - 영구시장의 과거 자금조달 비율 데이터를 가져옵니다.

• paradex_orderbook - 사용자 정의 가능한 깊이를 가진 시장의 현재 주문장을 가져옵니다.

• paradex_klines - 시장의 과거 캔들스틱(OHLCV) 데이터 가져오기

• paradex_trades - 가격, 규모 및 타임스탬프 정보와 함께 시장의 최근 거래를 가져옵니다.

• paradex_bbo - 시장에 대한 최고 입찰가와 최고 매도가(가장 좁은 스프레드)를 얻습니다.

계정 도구

• paradex_account_summary - 계정 요약 정보 가져오기

• paradex_account_positions - 현재 계좌 위치 가져오기

• paradex_account_fills - 계정 거래 채우기 받기

• paradex_account_funding_payments - 계정 자금 지급 받기

• paradex_account_transactions - 계좌 거래 내역 가져오기

주문 도구

• paradex_open_orders - 계정의 모든 미결 주문을 가져옵니다.

• paradex_create_order - Paradex에서 새 주문을 만듭니다.

• paradex_cancel_orders - 기존 주문 취소

• paradex_order_status - 주문 상태를 가져옵니다

• paradex_orders_history - 계정의 과거 주문 내역 가져오기

볼트 도구

• paradex_vaults - 필터링 옵션을 사용하여 특정 볼트 또는 모든 볼트에 대한 자세한 정보를 얻습니다.

• paradex_vaults_config - 수수료, 한도 및 기타 설정을 포함한 볼트에 대한 글로벌 구성을 가져옵니다.

• paradex_vault_balance - 사용 가능/잠긴 자금 정보와 함께 금고의 현재 잔액을 가져옵니다.

• paradex_vault_summary - 볼트 성능, 잔액 및 활동에 대한 포괄적인 요약을 받으세요

• paradex_vault_transfers - 금고의 입금 및 출금 내역을 가져옵니다.

• paradex_vault_positions - 시장, 크기, 진입 가격 세부 정보와 함께 볼트의 현재 거래 포지션을 가져옵니다.

• paradex_vault_account_summary - 마진 및 위험 지표를 포함한 볼트의 거래 계좌 정보를 가져옵니다.

거래 분석 프롬프트

이 MCP 서버는 AI 보조자가 복잡한 거래 분석을 수행하고 거래 전략을 생성하는 데 사용할 수 있는 체계적인 프롬프트를 제공합니다.

시장 분석

• market_overview - 수익/손실이 가장 큰 종목, 거래량이 많은 시장, 자금 조달 비율 이상, 시장 미시 구조 분석을 포함한 암호화폐 시장에 대한 포괄적인 개요를 확인하세요.

• market_analysis - 특정 시장에 대한 자세한 기술적 분석 및 미시 구조 분석(지지/저항 수준, 차트 패턴, 주문장 분석 및 포지션 권장 사항 포함)

포지션 및 포트폴리오 관리

• position_management - 포트폴리오 열, 상관 관계, 위험 지표, 이익 실현 및 손실 관리를 위한 특정 권장 사항을 포함한 기존 포지션에 대한 포괄적인 분석

• create_optimal_order - 변동성, 유동성, 위험 허용도 및 이상적인 진입 전략을 기반으로 시장에 대한 최적의 주문 매개변수를 설계합니다.

• hedging_strategy - 상관 관계 분석, 헤지 비율 계산 및 구현 계획을 사용하여 특정 포지션에 대한 효과적인 헤징 전략을 개발합니다.

• portfolio_risk_assessment 평가 - 노출 분석, 상관 관계 평가, VaR 계산 및 위험 감소 권장 사항을 포함한 거래 포트폴리오의 철저한 위험 분석

• liquidation_protection - 심각도 분류 및 보호 전략을 통해 공개 포지션에 대한 청산 위험을 식별하고 완화합니다.

투자 전략

• vault_analysis - 성과 지표, 위험 프로필 및 적합성 평가를 통해 투자 결정을 위한 볼트에 대한 포괄적인 분석

• funding_rate_opportunity - 수익률 계산 및 구현 전략을 포함하여 시장 전반의 자금 조달 비율 차익 거래 기회를 식별하고 평가합니다.

• trading_consultation - 개인화된 거래 조언 및 상담을 위한 대화형 프롬프트 시퀀스

MCP 문서

우리는 클라이언트에게 Paradex 문서에 대한 액세스를 제공함으로써 훨씬 더 나은 결과를 보았습니다.

기여하다

이 프로젝트에 참여하는 방법, 개발 설정 및 코딩 표준에 대한 자세한 내용은 CONTRIBUTING.md를 참조하세요.

특허

MIT 라이센스