xrpl-mcp-service

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides comprehensive access to the XRP Ledger (XRPL) through various endpoints including account information, decentralized exchange functionality, NFT operations, trust lines & payments, and system operations.

XRPL MCP 서비스

XRP 원장(XRPL)에 대한 포괄적인 접근을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서비스를 통해 AI 모델은 표준화된 엔드포인트를 통해 XRPL과 상호 작용할 수 있습니다.

특징

계정 정보

  • xrpl_account_info - 기본 계정 세부 정보
  • xrpl_account_balances - XRP 및 토큰 잔액(사람이 읽을 수 있음)
  • xrpl_account_lines - 신뢰 라인
  • xrpl_account_offers - 활성 거래 제안
  • xrpl_account_nfts - NFT 보유량
  • xrpl_account_tx - 거래 내역

탈중앙화 거래소

  • xrpl_order_book - 통화 쌍에 대한 주문장 보기
  • xrpl_market_price - 현재 시장 가격을 알아보세요
  • xrpl_amm_info - 자동화된 마켓 메이커 정보

NFT 운영

  • xrpl_nft_offers - NFT 매수/매도 제안 보기

신뢰 라인 및 지불

  • xrpl_set_trust_line - 새로운 신뢰 라인 설정
  • xrpl_remove_trust_line - 기존 신뢰 라인 제거
  • xrpl_payment_channels - 결제 채널 정보
  • xrpl_find_path - 결제 경로 찾기
  • xrpl_deposit_auth - 결제 승인 확인

체계

  • xrpl_server_info - 노드 상태 및 정보
  • xrpl_submit_tx - 서명된 거래 제출

설정

  1. .env 파일을 만듭니다.

지엑스피1

  1. 종속성 설치:
pip install xrpl-py fastapi uvicorn python-dotenv
  1. 서버를 실행합니다:
uvicorn main:app --host 0.0.0.0 --port 8000 --reload

API 사용 예

계정 정보 받기

POST /call-tool/xrpl_account_info { "account": "rsuUjfWxrACCAwGQDsNeZUhpzXf1n1NK5Z" }

계좌 잔액 가져오기

POST /call-tool/xrpl_account_balances { "account": "rsuUjfWxrACCAwGQDsNeZUhpzXf1n1NK5Z" }

신뢰 라인 설정

POST /call-tool/xrpl_set_trust_line { "wallet_seed": "sXXXXXXXXXXXXXXXXXXXX", "currency": "USD", "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "limit": "1000" }

AMM 정보 받기

POST /call-tool/xrpl_amm_info { "asset": { "currency": "XRP" }, "asset2": { "currency": "USD", "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B" } }

시장 가격을 알아보세요

POST /call-tool/xrpl_market_price { "base_currency": { "currency": "XRP" }, "quote_currency": { "currency": "USD", "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B" } }

프로젝트 구조

├── main.py # FastAPI application entry point ├── tools/ │ ├── __init__.py │ ├── register_tools.py # Tool registration │ └── xrpl_tools.py # XRPL endpoint implementations

주요 구성 요소

  1. xrpl_tools.py
    • 핵심 XRPL 상호 작용 함수
    • 이벤트 루프 처리를 통한 비동기 구현
    • 오류 처리 및 응답 형식 지정
  2. register_tools.py
    • MCP 도구 등록
    • 엔드포인트 매핑 및 구성

향후 개선 사항

  1. AMM(유동성 풀) 운영
    • 풀 만들기
    • 유동성 추가/제거
    • 풀 매개변수에 대한 투표
  2. 고급 트레이딩
    • 제안 생성/취소
    • 자동 거래 기능
    • 가격 알림
  3. NFT 운영
    • 민트 NFT
    • 제안 생성/수락
    • 컬렉션 관리

일반적인 문제

  1. 비동기 이벤트 루프 : "asyncio.run()을 실행 중인 이벤트 루프에서 호출할 수 없습니다"라는 메시지가 표시되면 xrpl_tools.py에서 비동기 구현을 확인하세요.
  2. 속도 제한 : 프로덕션 사용을 위해 속도 제한 구현을 고려하세요.

기여하다

  1. 저장소를 포크하세요
  2. 기능 브랜치 생성
  3. 변경 사항을 구현하세요
  4. 풀 리퀘스트 제출

중요 참고 사항

  • 생산에는 항상 "검증된" 원장을 사용하세요.
  • 안전한 지갑 시드 및 개인 키
  • 거래 수수료 모니터링
  • 먼저 테스트넷에서 철저히 테스트하세요

자원

특허

MIT

-
security - not tested
F
license - not found
-
quality - not tested

XRP 원장(XRPL)에 대한 포괄적인 접근을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서비스를 통해 AI 모델은 표준화된 엔드포인트를 통해 XRPL과 상호 작용할 수 있습니다.

  1. Features
    1. Account Information
    2. Decentralized Exchange
    3. NFT Operations
    4. Trust Lines & Payments
    5. System
  2. Setup
    1. API Usage Examples
      1. Get Account Info
      2. Get Account Balances
      3. Set Trust Line
      4. Get AMM Info
      5. Get Market Price
    2. Project Structure
      1. Key Components
        1. Future Enhancements
          1. Common Issues
            1. Contributing
              1. Important Notes
                1. Resources
                  1. License
                    ID: qh6y5cvx2o