Algorand MCP 구현
개요
모델 컨텍스트 프로토콜 (MCP)은 애플리케이션이 LLM에 컨텍스트를 제공하는 방식을 표준화하는 개방형 프로토콜입니다. MCP는 LLM이 더욱 유용하고 효과적으로 작업할 수 있도록 도구, 리소스 및 지침을 제공하는 사양 표준을 제공합니다.
MCP Github 에는 MCP에 대한 자세한 정보와 다양한 도구, 사양, 문서가 포함되어 있습니다.
이 저장소는 Algorand 블록체인 상호작용을 위한 모델 컨텍스트 프로토콜(MCP) 구현입니다. 구현은 다음으로 구성됩니다.
- (생산) 블록체인 상호작용을 위한 서버 패키지(Node.js만 해당)
- (WIP) 지갑 관리 및 거래 서명을 위한 클라이언트 패키지(브라우저와 Node.js 모두 지원)
📦 이 저장소의 패키지:
📦 NPM:
📦 대장간:
특징
- Algorand 문서 통합 완료
- 전체 Algorand 지식 분류법
- 포괄적인 개발자 문서
- ARC, SDK 및 도구 설명서
- 지식 도구를 통한 직접 문서 접근
- 완벽한 Algorand 블록체인 상호 작용 기능
- 광범위한 지갑 관리 시스템
- 포괄적인 거래 처리
- 풍부한 블록체인 상태 쿼리
- 내장된 보안 기능
- Claude Desktop 및 Cursor 통합 지원
요구 사항
- Node.js v23.6.1 이상
- npm v10.2.4 이상
설치
Algorand MCP 구현을 설치하거나 업데이트하려면 저장소를 복제하고 종속성을 설치한 다음 프로젝트를 빌드하세요.
먼저 노드 버전이 23.6.1 이상인지 확인하세요.
지엑스피1
필요하면 23.6.1 이상으로 업그레이드하세요!
그런 다음 Claude 또는 Cursor 컨테이너 폴더에 mcp-servers 폴더가 있는지 확인합니다(없으면 하나 만듭니다).
mkdir PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor
mkdir PATH_ON_YOUR_MACHINE/Cursor/mcp-servers
그런 다음 mcp-servers 폴더 아래에 이 저장소를 복제하고 종속성을 설치합니다.
cd PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor
cd PATH_ON_YOUR_MACHINE/Cursor/mcp-servers
# Clone the repository
git clone https://github.com/GoPlausible/algorand-mcp.git
cd algorand-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Edit the .env file to set your configurations
이제 완료되었습니다! 이제 MCP 설정을 열고 서버를 다음과 같이 추가할 수 있습니다.
{
"mcpServers": {
"algorand-mcp": {
"command": "node",
"args": [
"PATH_ON_YOUR_MACHINE/Claude/mcp-servers/algorand-mcp/packages/server/dist/index.js"
],
"env": {
"ALGORAND_NETWORK": "testnet",
"ALGORAND_ALGOD_API": "https://testnet-api.algonode.cloud/v2",
"ALGORAND_ALGOD": "https://testnet-api.algonode.cloud",
"ALGORAND_INDEXER_API": "https://testnet-idx.algonode.cloud/v2",
"ALGORAND_INDEXER": "https://testnet-idx.algonode.cloud",
"ALGORAND_ALGOD_PORT": "",
"ALGORAND_INDEXER_PORT": "",
"ALGORAND_TOKEN": "",
"ALGORAND_AGENT_WALLET": "problem aim online jaguar upper oil flight stumble mystery aerobic toy avoid file tomato moment exclude witness guard lab opera crunch noodle dune abandon broccoli",
"NFD_API_URL": "https://api.nf.domains",
"NFD_API_KEY": "",
"TINYMAN_ACTIVE": "false",
"ULTRADE_ACTIVE": "false",
"ULTRADE_API_URL": "https://api.ultrade.io",
"VESTIGE_ACTIVE": "false",
"VESTIGE_API_URL": "https://api.vestigelabs.org",
"VESTIGE_API_KEY": "",
"ITEMS_PER_PAGE": "10"
}
}
}
}
로컬 시스템의 경로와 일치하도록 경로를 변경해야 합니다.
예를 들어 MACOS와 Claud의 경우 경로는 다음과 같습니다.
{
"mcpServers": {
"algorand-mcp": {
"command": "node",
"args": [
" /Users/YOUR_USERNAME/Library/Application\ Support/Claude/mcp-servers/algorand-mcp/packages/server/dist/index.js"
]
}
}
}
프로젝트 아키텍처
이 프로젝트는 두 가지 주요 패키지로 구성된 모듈형 아키텍처를 따릅니다.
- 서버 패키지(
@algorand-mcp/server )- MCP 도구 및 리소스 제공
- 블록체인 상호작용을 관리합니다
- 거래 생성 및 제출을 처리합니다.
- 포괄적인 블록체인 쿼리를 제공합니다
- 클라이언트 패키지(
@algorand-mcp/client )- 지갑 연결 및 거래 서명을 처리합니다.
- 로컬 및 외부 지갑을 모두 지원합니다
- 범용 호환성(브라우저/Node.js)
- 보안 자격 증명 관리
- 아직 작업 중입니다(서버는 클라이언트 상태와 무관하게 작동합니다)
프로젝트 구조
algorand-mcp/
├── packages/
│ ├── client/ # Client Package
│ │ ├── src/
│ │ │ ├── index.ts # Client entry point and wallet management
│ │ │ └── LocalWallet.ts # Local wallet implementation
│ │ ├── package.json
│ │ └── tsconfig.json
│ └── server/ # Server Package
│ ├── src/
│ │ ├── resources/ # MCP Resources (User-invokable endpoints)
│ │ │ ├── knowledge/ # Documentation and taxonomy
│ │ │ │ ├── taxonomy/ # Markdown documentation
│ │ │ │ └── index.ts # Knowledge resource handler
│ │ │ ├── wallet/ # Wallet management
│ │ │ │ └── index.ts # Wallet resource handler
│ │ │ └── index.ts # Resource registration
│ │ ├── tools/ # MCP Tools (Agent-invokable operations)
│ │ │ ├── accountManager.ts # Account operations
│ │ │ ├── algodManager.ts # Node interactions
│ │ │ ├── utilityManager.ts # Utility functions
│ │ │ ├── apiManager/ # API Tools
│ │ │ │ ├── algod/ # Algod API tools
│ │ │ │ ├── indexer/ # Indexer API tools
│ │ │ │ ├── nfd/ # NFDomains tools
│ │ │ │ ├── vestige/ # Vestige DeFi tools
│ │ │ │ ├── tinyman/ # Tinyman AMM tools
│ │ │ │ └── ultrade/ # Ultrade DEX tools
│ │ │ └── transactionManager/ # Transaction handling
│ │ ├── env.ts # Environment configuration
│ │ └── index.ts # Server entry point
│ ├── package.json
│ └── tsconfig.json
├── package.json # Root package file
└── tsconfig.json # Root TypeScript config
핵심 기능
서버 기능
- 계정 관리
- 자산 운영
- 애플리케이션 상호 작용
- 거래 생성 및 제출
- 블록체인 상태 쿼리
- 포괄적인 유틸리티 함수
- 표준화된 응답 형식
- 내장된 페이지 매김 지원
- 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 모듈 지원
응답 형식
모든 응답은 표준화된 형식을 따릅니다.
{
"data": {
// Response data here
},
"metadata": { // Only for paginated responses
"totalItems": number,
"itemsPerPage": number,
"currentPage": number,
"totalPages": number,
"hasNextPage": boolean,
"pageToken": string,
"arrayField": string // Name of paginated array field
}
}
오류는 표준화된 형식으로 반환됩니다.
{
"error": {
"code": string,
"message": string
}
}
사용 가능한 도구 및 리소스
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 도구
- 도구 보기:
- 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: 스왑 가져오기
- 스왑 도구:
- 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: 애그리게이터 통계 가져오기
- 통화 도구:
- 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 도구
- 지갑 도구:
- 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: 출금 데이터로부터 메시지 생성
- 마켓 도구:
- 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: 여러 개의 미결 주문 취소
- 시스템 도구:
- 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