Algorand MCP 구현

개요

모델 컨텍스트 프로토콜 (MCP)은 애플리케이션이 LLM에 컨텍스트를 제공하는 방식을 표준화하는 개방형 프로토콜입니다. MCP는 LLM이 더욱 유용하고 효과적으로 작업할 수 있도록 도구, 리소스 및 지침을 제공하는 사양 표준을 제공합니다.

MCP Github 에는 MCP에 대한 자세한 정보와 다양한 도구, 사양, 문서가 포함되어 있습니다.

이 저장소는 Algorand 블록체인 상호작용을 위한 모델 컨텍스트 프로토콜(MCP) 구현입니다. 구현은 다음으로 구성됩니다.

• (생산) 블록체인 상호작용을 위한 서버 패키지(Node.js만 해당)
• (WIP) 지갑 관리 및 거래 서명을 위한 클라이언트 패키지(브라우저와 Node.js 모두 지원)

📦 이 저장소의 패키지:

• Algorand MCP 서버 - Algorand MCP 서버 전체 구현.
• Algorand MCP 클라이언트 - 클라이언트 측 지갑 관리 및 거래 서명, 그리고 다른 에이전트 호스트와의 통합을 위한 Algorand MCP 클라이언트입니다.

📦 NPM:

• Algorand MCP 서버 NPM 패키지 - NPM 패키지 설치를 통한 Algorand MCP 서버 구현.

📦 대장간:

• Smithery의 Algorand MCP 서버 - smithery를 통한 Algorand MCP 서버 구현.

특징

• Algorand 문서 통합 완료
  • 전체 Algorand 지식 분류법
  • 포괄적인 개발자 문서
  • ARC, SDK 및 도구 설명서
  • 지식 도구를 통한 직접 문서 접근
• 완벽한 Algorand 블록체인 상호 작용 기능
• 광범위한 지갑 관리 시스템
• 포괄적인 거래 처리
• 풍부한 블록체인 상태 쿼리
• 내장된 보안 기능
• Claude Desktop 및 Cursor 통합 지원

요구 사항

• Node.js v23.6.1 이상
• npm v10.2.4 이상

설치

NPM을 통해(자체 인스턴스를 실행하려는 개발자용)

지엑스피1

Via Smithery (모든 사용자용)

Smithery(Claude Desktop용)를 통해

터미널에서 다음 명령을 실행하세요.

Smithery(커서용)를 통해

터미널에서 다음 명령을 실행하세요:

중요 참고 사항 Smithery UI를 사용하여 명령을 복사할 때 연결을 클릭하기 전에 ITEMS_PER_PAGE를 설정하여 모든 ENV 변수가 명령으로 전달되도록 해야 합니다. 그렇지 않으면 명령에 Algorand MCP 실행에 필요한 환경 변수가 포함되지 않습니다!

프로젝트 아키텍처

이 프로젝트는 두 가지 주요 패키지로 구성된 모듈형 아키텍처를 따릅니다.

1. 서버 패키지( @algorand-mcp/server )
   • MCP 도구 및 리소스 제공
   • 블록체인 상호작용을 관리합니다
   • 거래 생성 및 제출을 처리합니다.
   • 포괄적인 블록체인 쿼리를 제공합니다
2. 클라이언트 패키지( @algorand-mcp/client )
   • 지갑 연결 및 거래 서명을 처리합니다.
   • 로컬 및 외부 지갑을 모두 지원합니다
   • 범용 호환성(브라우저/Node.js)
   • 보안 자격 증명 관리
   • 아직 작업 중입니다(서버는 클라이언트 상태와 무관하게 작동합니다)

프로젝트 구조

핵심 기능

서버 기능

• 계정 관리
• 자산 운영
• 애플리케이션 상호 작용
• 거래 생성 및 제출
• 블록체인 상태 쿼리
• 포괄적인 유틸리티 함수
• 표준화된 응답 형식
• 내장된 페이지 매김 지원
• NFDomains 통합
• Vestige DeFi 분석
• Tinyman AMM 통합
• Ultrade DEX 통합
• 지식 분류 리소스:
  • 전체 문서 분류법(algorand://knowledge/taxonomy)
  • 카테고리별 문서:
    • ARC(알고리즘://지식/분류학/아크)
    • SDK(algorand://knowledge/taxonomy/sdks)
    • 알고킷(AlgoKit)
    • AlgoKit Utils(algorand://knowledge/taxonomy/algokit-utils)
    • TEALScript(알고리즘://지식/분류학/tealscript)
    • 푸야(algorand://knowledge/taxonomy/puya)
    • Liquid Auth(알고리즘://지식/분류/액체 인증)
    • 파이썬(algorand://knowledge/taxonomy/python)
    • 개발자 문서(algorand://knowledge/taxonomy/developers)
    • CLI 도구(algorand://knowledge/taxonomy/clis)
    • 노드 관리(algorand://knowledge/taxonomy/nodes)
    • 기술 세부 정보(algorand://knowledge/taxonomy/details)

클라이언트 기능(작업 진행 중)

• 안전한 저장 기능을 갖춘 로컬 지갑
• 외부 지갑 지원(Pera, Defly, Daffi)
• 거래 서명
• 세션 관리
• 유니버설 ES 모듈 지원

응답 형식

모든 응답은 표준화된 형식을 따릅니다.

오류는 표준화된 형식으로 반환됩니다.

사용 가능한 도구 및 리소스

Algorand MCP 구현은 블록체인 상호 작용을 위한 125개의 도구와 리소스를 제공합니다.

• 40개의 기본 도구(계정, 자산, 애플리케이션, 거래 관리)
• 30개의 API 도구(algo 및 인덱서)
• 이름 서비스를 위한 6개의 NFDomains(NFD) 도구
• DeFi 분석을 위한 28가지 Vestige 도구
• AMM 상호 작용을 위한 9가지 Tinyman 도구
• DEX 기능을 위한 12개의 Ultrade 도구

API 도구

Algod API 도구

• api_algod_get_account_info: 현재 계좌 잔액, 자산 및 인증 주소를 가져옵니다.
• api_algod_get_account_application_info: 계정별 애플리케이션 정보를 가져옵니다.
• api_algod_get_account_asset_info: 계정별 자산 정보를 가져옵니다.
• api_algod_get_application_by_id: 애플리케이션 정보 가져오기
• api_algod_get_application_box: 이름으로 애플리케이션 상자 가져오기
• api_algod_get_application_boxes: 모든 애플리케이션 상자 가져오기
• api_algod_get_asset_by_id: 현재 자산 정보를 가져옵니다.
• api_algod_get_pending_transaction: 보류 중인 거래 정보를 가져옵니다.
• api_algod_get_pending_transactions_by_address: 주소에 대한 보류 중인 거래를 가져옵니다.
• api_algod_get_pending_transactions: 보류 중인 모든 거래를 가져옵니다.
• api_algod_get_transaction_params: 제안된 거래 매개변수 가져오기
• api_algod_get_node_status: 현재 노드 상태 가져오기
• api_algod_get_node_status_after_block: 특정 라운드 이후 노드 상태 가져오기

인덱서 API 도구

• api_indexer_lookup_account_by_id: 계정 정보 가져오기
• api_indexer_lookup_account_assets: 계정 자산 가져오기
• api_indexer_lookup_account_app_local_states: 계정 신청 로컬 상태 가져오기
• api_indexer_lookup_account_created_applications: 계정별로 생성된 애플리케이션을 가져옵니다.
• api_indexer_search_for_accounts: 다양한 기준으로 계정 검색
• api_indexer_lookup_applications: 애플리케이션 정보 가져오기
• api_indexer_lookup_application_logs: 애플리케이션 로그 메시지 가져오기
• api_indexer_search_for_applications: 애플리케이션 검색
• api_indexer_lookup_asset_by_id: 자산 정보 및 구성 가져오기
• api_indexer_lookup_asset_balances: 이 자산을 보유한 계정을 가져옵니다.
• api_indexer_lookup_asset_transactions: 이 자산과 관련된 거래를 가져옵니다.
• api_indexer_search_for_assets: 자산 검색
• api_indexer_lookup_transaction_by_id: 거래 정보 가져오기
• api_indexer_lookup_account_transactions: 계좌 거래 내역 가져오기
• api_indexer_search_for_transactions: 거래 검색

NFDomains(NFD) API 도구

• api_nfd_get_nfd: 이름 또는 애플리케이션 ID로 NFD 가져오기
• api_nfd_get_nfds_for_addresses: 특정 주소에 대한 NFD 가져오기
• api_nfd_get_nfd_activity: NFD에 대한 활동/변경 사항 가져오기
• api_nfd_get_nfd_analytics: NFD에 대한 분석 데이터 가져오기
• api_nfd_browse_nfds: 다양한 필터로 NFD 탐색
• api_nfd_search_nfds: 다양한 필터로 NFD 검색

베스티지 API 도구

1. 도구 보기:

• api_vestige_view_networks: 모든 네트워크 가져오기
• api_vestige_view_network_by_id: ID로 네트워크 가져오기
• api_vestige_view_protocols: 모든 프로토콜 가져오기
• api_vestige_view_protocol_by_id: ID로 프로토콜 가져오기
• api_vestige_view_protocol_volumes: 특정 날짜의 프로토콜 볼륨 가져오기
• api_vestige_view_assets: 자산에 대한 데이터 가져오기
• api_vestige_view_assets_list: 자산 목록 가져오기
• api_vestige_view_assets_search: 쿼리로 자산 검색
• api_vestige_view_asset_price: 자산 가격 가져오기
• api_vestige_view_asset_candles: 자산 캔들 가져오기
• api_vestige_view_asset_history: 자산 거래량, 스왑, 총 잠금, vwap 및 신뢰 내역을 가져옵니다.
• api_vestige_view_asset_composition: 프로토콜 및 쌍을 기반으로 자산 잠금을 가져옵니다.
• api_vestige_view_pools: 풀 가져오기
• api_vestige_view_vaults: 모든 볼트 가져오기
• api_vestige_view_balances: 네트워크 ID, 프로토콜 ID 및 자산 ID별 잔액을 가져옵니다.
• api_vestige_view_notes: 네트워크 ID 및 선택적으로 자산 ID로 메모 가져오기
• api_vestige_view_first_asset_notes: 자산에 대한 첫 번째 메모를 가져옵니다.
• api_vestige_view_asset_notes_count: 자산에 대한 노트 수를 가져옵니다.
• api_vestige_view_swaps: 스왑 가져오기

2. 스왑 도구:

• api_vestige_get_best_v4_swap_data: 최상의 V4 스왑 데이터 가져오기
• api_vestige_get_v4_swap_discount: V4 스왑 할인 받기
• api_vestige_get_v4_swap_data_transactions: V4 스왑 데이터 트랜잭션 가져오기
• api_vestige_get_aggregator_stats: 애그리게이터 통계 가져오기

3. 통화 도구:

• api_vestige_view_currency_prices: 최신 통화 가격을 모두 확인하세요
• api_vestige_view_currency_price_history: 타임스탬프 범위별 통화 가격 가져오기
• api_vestige_view_currency_price: 타임스탬프로 통화 가격을 가져옵니다
• api_vestige_view_currency_average_price: 통화의 평균 가격을 가져옵니다.
• api_vestige_view_currency_prices_simple_30d: 지난 30일간의 통화 가격을 가져옵니다.

Tinyman API 도구

• api_tinyman_get_pool: 자산 쌍으로 Tinyman 풀 정보 가져오기
• api_tinyman_get_pool_analytics: Tinyman 풀에 대한 분석 가져오기
• api_tinyman_get_pool_creation_quote: 새 풀 생성에 대한 견적을 받으세요
• api_tinyman_get_liquidity_quote: 유동성 추가에 대한 견적을 받으세요
• api_tinyman_get_remove_liquidity_quote: 유동성 제거에 대한 견적을 받으세요
• api_tinyman_get_swap_quote: 자산 교환에 대한 견적 받기
• api_tinyman_get_asset_optin_quote: 풀 토큰 가입에 대한 견적 받기
• api_tinyman_get_validator_optin_quote: 검증기 가입에 대한 견적을 받으세요
• api_tinyman_get_validator_optout_quote: 검증기에서 옵트아웃하기 위한 견적을 받으세요

Ultrade API 도구

1. 지갑 도구:

• api_ultrade_wallet_signin_message: 로그인 데이터에서 메시지 생성
• api_ultrade_wallet_signin: 거래 계좌에 로그인
• api_ultrade_wallet_add_key: 거래 키 추가
• api_ultrade_wallet_revoke_key: 거래 키 취소
• api_ultrade_wallet_keys: 거래 키 가져오기
• api_ultrade_wallet_key_message: 거래 키 데이터로부터 메시지 생성
• api_ultrade_wallet_trades: 필터링된 지갑 거래 가져오기
• api_ultrade_wallet_transactions: 필터링된 지갑 거래 가져오기
• api_ultrade_wallet_withdraw: 토큰 인출
• api_ultrade_wallet_withdraw_message: 출금 데이터로부터 메시지 생성

2. 마켓 도구:

• api_ultrade_market_symbols: 시장 심볼 가져오기
• api_ultrade_market_details: 시장 세부 정보 가져오기
• api_ultrade_market_price: 쌍별 심볼별 마지막 시장 가격을 가져옵니다.
• api_ultrade_market_depth: 주문장 깊이 가져오기
• api_ultrade_market_last_trades: 마지막 거래 내역 가져오기
• api_ultrade_market_history: 시장 내역 가져오기
• api_ultrade_market_assets: 거래 자산 가져오기
• api_ultrade_market_fee_rates: 수수료율을 알아보세요
• api_ultrade_market_chains: 블록체인 체인 가져오기
• api_ultrade_market_withdrawal_fee: 출금 수수료 받기
• api_ultrade_market_operation_details: 작업 세부 정보를 가져옵니다.
• api_ultrade_market_settings: 시장 설정 가져오기
• api_ultrade_market_orders: 주문 받기
• api_ultrade_market_open_orders: 미결 주문 가져오기
• api_ultrade_market_order_by_id: ID로 주문 가져오기
• api_ultrade_market_order_message: 주문 데이터로부터 메시지 생성
• api_ultrade_market_create_order: 새 주문 생성
• api_ultrade_market_create_orders: 새로운 주문 생성
• api_ultrade_market_cancel_order: 미결 주문 취소
• api_ultrade_market_cancel_orders: 여러 개의 미결 주문 취소

3. 시스템 도구:

• api_ultrade_system_time: 현재 시스템 시간을 가져옵니다
• api_ultrade_system_maintenance: 시스템 유지 관리 상태를 가져옵니다.
• api_ultrade_system_version: 시스템 버전 가져오기

계정 관리 도구

• create_account: 새로운 Algorand 계정을 만듭니다
• rekey_account: 계정을 새 주소로 다시 키로 지정합니다.
• validate_address: Algorand 주소가 유효한지 확인합니다.
• encode_address: 공개 키를 Algorand 주소로 인코딩합니다.
• decode_address: Algorand 주소를 공개 키로 디코딩합니다.

응용 프로그램 도구

• make_app_create_txn: 애플리케이션 생성 트랜잭션을 생성합니다.
• make_app_update_txn: 애플리케이션 업데이트 트랜잭션을 생성합니다.
• make_app_delete_txn: 애플리케이션 삭제 트랜잭션을 생성합니다.
• make_app_optin_txn: 애플리케이션 옵트인 거래 생성
• make_app_closeout_txn: 애플리케이션 종료 거래 생성
• make_app_clear_txn: 애플리케이션 상태 지우기 트랜잭션을 생성합니다.
• make_app_call_txn: 애플리케이션 호출 트랜잭션을 생성합니다.
• get_application_address: 주어진 애플리케이션 ID에 대한 주소를 가져옵니다.
• compile_teal: TEAL 소스 코드 컴파일
• disassemble_teal: TEAL 바이트코드를 소스로 디스어셈블합니다.

자산 도구

• make_asset_create_txn: 자산 생성 트랜잭션을 생성합니다.
• make_asset_config_txn: 자산 구성 트랜잭션을 생성합니다.
• make_asset_destroy_txn: 자산 파괴 트랜잭션을 생성합니다.
• make_asset_freeze_txn: 자산 동결 거래 생성
• make_asset_transfer_txn: 자산 이전 거래 생성

거래 도구

• send_raw_transaction: 서명된 거래를 네트워크에 제출합니다.
• simulate_raw_transactions: 원시 거래 시뮬레이션
• simulate_transactions: 세부적인 구성으로 거래 시뮬레이션
• make_payment_txn: 결제 거래 생성
• assign_group_id: 거래 목록에 그룹 ID를 지정합니다.
• sign_transaction: 비밀 키로 거래에 서명합니다.

키 관리 도구

• mnemonic_to_mdk: 니모닉을 마스터 파생 키로 변환
• mdk_to_mnemonic: 마스터 파생 키를 니모닉으로 변환
• secret_key_to_mnemonic: 비밀 키를 니모닉으로 변환합니다.
• mnemonic_to_secret_key: 니모닉을 비밀 키로 변환
• seed_from_mnemonic: 니모닉에서 시드를 생성합니다.
• mnemonic_from_seed: 시드에서 니모닉을 생성합니다.
• sign_bytes: 비밀 키로 임의의 바이트에 서명합니다.

유틸리티 도구

• bytes_to_bigint: 바이트를 BigInt로 변환
• bigint_to_bytes: BigInt를 바이트로 변환
• encode_uint64: uint64를 바이트로 인코딩합니다.
• decode_uint64: 바이트를 uint64로 디코딩
• generate_algorand_uri: ARC-26 사양에 따라 Algorand URI 및 QR 코드를 생성합니다.

종속성

• algosdk: Algorand JavaScript SDK
• @perawallet/connect: Pera Wallet 커넥터
• @blockshake/defly-connect: Defly Wallet 커넥터
• @daffiwallet/connect: Daffi Wallet 커넥터

특허

MIT