MCP 서버 - 클러스터 API v1
이는 클러스터 API v1을 위한 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 인증, 클러스터 관리, 이름 등록 등의 엔드포인트를 제공합니다.
종속성
지엑스피1
설정
- 종속성 설치:
- CLUSTERS_API_KEY={CLUSTERS_API_KEY}를 사용하여
.env 파일을 만듭니다. - 서버를 빌드하고 시작합니다.
테스트 엔드포인트
이 서버는 StdioServerTransport 사용하므로 stdin을 통해 JSON-RPC 메시지를 전송해야 합니다. 각 엔드포인트를 테스트하기 위한 명령 예시는 다음과 같습니다.
인증 엔드포인트
메시지 받기
echo '{"jsonrpc":"2.0","id":1,"method":"auth_get_message","params":{"address":"0x123...","chainId":1,"nonce":"abc123"}}' | node dist/index.js
토큰 받기
echo '{"jsonrpc":"2.0","id":1,"method":"auth_get_token","params":{"signature":"0x123...","signingDate":"2024-03-21","type":"evm","wallet":"0x123..."}}' | node dist/index.js
토큰 검증
echo '{"jsonrpc":"2.0","id":1,"method":"auth_validate_token","params":{"authKey":"your-auth-key"}}' | node dist/index.js
클러스터 관리 엔드포인트
클러스터 생성
echo '{"jsonrpc":"2.0","id":1,"method":"create_cluster","params":{"wallets":[{"address":"0x123...","name":"MyWallet","isPrivate":false}],"authKey":"your-auth-key","testnet":false}}' | node dist/index.js
ID로 클러스터 가져오기
echo '{"jsonrpc":"2.0","id":1,"method":"get_cluster_by_id","params":{"id":"cluster-id","testnet":false}}' | node dist/index.js
이름으로 클러스터 가져오기
echo '{"jsonrpc":"2.0","id":1,"method":"get_cluster_by_name","params":{"name":"cluster-name","testnet":false}}' | node dist/index.js
주소로 클러스터 ID 가져오기
echo '{"jsonrpc":"2.0","id":1,"method":"get_cluster_id_by_address","params":{"address":"0x123...","testnet":false}}' | node dist/index.js
지갑 추가
echo '{"jsonrpc":"2.0","id":1,"method":"add_wallets","params":{"wallets":[{"address":"0x123...","name":"NewWallet","isPrivate":false}],"authKey":"your-auth-key","testnet":false}}' | node dist/index.js
지갑 생성
echo '{"jsonrpc":"2.0","id":1,"method":"generate_wallet","params":{"type":"evm","name":"NewWallet","isPrivate":false,"authKey":"your-auth-key","testnet":false}}' | node dist/index.js
지갑 업데이트
echo '{"jsonrpc":"2.0","id":1,"method":"update_wallets","params":{"wallets":[{"address":"0x123...","name":"UpdatedName"}],"authKey":"your-auth-key","testnet":false}}' | node dist/index.js
지갑 제거
echo '{"jsonrpc":"2.0","id":1,"method":"remove_wallets","params":{"addresses":["0x123..."],"authKey":"your-auth-key","testnet":false}}' | node dist/index.js
지갑 확인
echo '{"jsonrpc":"2.0","id":1,"method":"verify_wallet","params":{"clusterId":"cluster-id","authKey":"your-auth-key","testnet":false}}' | node dist/index.js
주소 ↔ 이름 확인 엔드포인트
주소로 데이터 가져오기
echo '{"jsonrpc":"2.0","id":1,"method":"get_data_by_address","params":{"address":"0x123...","testnet":false}}' | node dist/index.js
주소별 대량 데이터 가져오기
echo '{"jsonrpc":"2.0","id":1,"method":"get_bulk_data_by_addresses","params":{"addresses":["0x123...","0x456..."],"testnet":false}}' | node dist/index.js
이름으로 대량 데이터 가져오기
echo '{"jsonrpc":"2.0","id":1,"method":"get_bulk_data_by_names","params":{"names":[{"name":"name1"}],"testnet":false}}' | node dist/index.js
등록 엔드포인트
이름 가용성 확인
echo '{"jsonrpc":"2.0","id":1,"method":"check_name_availability","params":{"names":["name1","name2"]}}' | node dist/index.js
등록 서명 데이터 가져오기
echo '{"jsonrpc":"2.0","id":1,"method":"get_registration_sign_data","params":{"network":"1","sender":"0x123...","names":[{"name":"name1","amountWei":"1000000000000000000"}],"referralClusterId":"optional-id","testnet":false}}' | node dist/index.js
거래 상태 가져오기
echo '{"jsonrpc":"2.0","id":1,"method":"get_transaction_status","params":{"txHash":"0x123..."}}' | node dist/index.js
노트
- 플레이스홀더 값(예:
0x123... , your-auth-key 등)을 실제 값으로 교체합니다. testnet 매개변수는 대부분의 엔드포인트에 대해 선택 사항입니다.- 모든 응답은 JSON-RPC 2.0 형식이 됩니다.
- 인증된 엔드포인트의 경우 유효한
authKey 가져와 포함해야 합니다. - 서버는 구성을 위해 환경 변수를 사용합니다.
.env 파일이 올바르게 설정되었는지 확인하세요.
대체 테스트 방법
테스트를 더 쉽게 하려면 stdio 대신 HTTP 전송을 사용하도록 서버를 수정할 수 있습니다. 이렇게 하면 echo 파이프 대신 curl 명령을 사용할 수 있습니다. HTTP 전송으로 전환하고 싶으시면 알려주세요.