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
- 서명된 거래 제출
설정
.env
파일을 만듭니다.
지엑스피1
- 종속성 설치:
pip install xrpl-py fastapi uvicorn python-dotenv
- 서버를 실행합니다:
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
주요 구성 요소
- xrpl_tools.py
- 핵심 XRPL 상호 작용 함수
- 이벤트 루프 처리를 통한 비동기 구현
- 오류 처리 및 응답 형식 지정
- register_tools.py
향후 개선 사항
- AMM(유동성 풀) 운영
- 풀 만들기
- 유동성 추가/제거
- 풀 매개변수에 대한 투표
- 고급 트레이딩
- NFT 운영
일반적인 문제
- 비동기 이벤트 루프 : "asyncio.run()을 실행 중인 이벤트 루프에서 호출할 수 없습니다"라는 메시지가 표시되면 xrpl_tools.py에서 비동기 구현을 확인하세요.
- 속도 제한 : 프로덕션 사용을 위해 속도 제한 구현을 고려하세요.
기여하다
- 저장소를 포크하세요
- 기능 브랜치 생성
- 변경 사항을 구현하세요
- 풀 리퀘스트 제출
중요 참고 사항
- 생산에는 항상 "검증된" 원장을 사용하세요.
- 안전한 지갑 시드 및 개인 키
- 거래 수수료 모니터링
- 먼저 테스트넷에서 철저히 테스트하세요
자원
특허
MIT