MCP Paradex 서버

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

개요

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

• Paradex에서 시장 데이터 검색
• 거래 계좌 및 금고 관리
• 주문하기 및 관리하기
• 위치와 균형을 모니터링하세요

필수 조건

• 파이썬 3.10+

설치

Smithery를 통해 설치

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

지엑스피1

pip 사용하기

1. 이 저장소를 복제하세요:
   git clone https://github.com/sv/mcp-paradex-py.git cd mcp-paradex-py
2. 가상 환경 만들기:
   python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
3. 종속성 설치:
   pip install -e .

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. 종속성 설치:
   uv pip install -e .

구성

구성을 설정하세요:

그런 다음 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 설명서를 참조하세요.

사용 가능한 리소스 및 도구

자원

시스템 리소스

• system://status - 시스템 및 Paradex 연결의 현재 상태를 가져옵니다.
• system://version - 서버 및 종속성에 대한 자세한 버전 정보를 가져옵니다.
• system://health - 서버의 기본 상태 점검을 수행합니다.

시장 자원

• market://public/markets - Paradex에서 사용 가능한 시장 목록을 가져옵니다.
• market://public/info - 일반적인 시장 정보 및 상태를 가져옵니다.

볼트 리소스

• vaults://list - 계정과 연관된 모든 볼트를 나열합니다.
• vaults://balance - 특정 볼트의 잔액을 가져옵니다
• vaults://details - 볼트에 대한 자세한 정보를 얻습니다.

도구

시스템 도구

• 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 - 마진 및 위험 지표를 포함한 볼트의 거래 계좌 정보를 가져옵니다.

기여하다

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

특허

MIT 라이센스