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 - 서명된 거래 제출

Related MCP server: @lex-tools/codebase-context-dumper

설정

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

지엑스피1

2. 종속성 설치:

pip install xrpl-py fastapi uvicorn python-dotenv

3. 서버를 실행합니다:

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. 풀 리퀘스트 제출

중요 참고 사항

• 생산에는 항상 "검증된" 원장을 사용하세요.

• 안전한 지갑 시드 및 개인 키

• 거래 수수료 모니터링

• 먼저 테스트넷에서 철저히 테스트하세요

자원

• XRPL 문서

• MCP 프로토콜 문서

• FastAPI 문서

특허

MIT