MCP Badge

Ankr API MCP 서버

Ankr API를 통해 블록체인 데이터를 제공하는 MCP(Model Context Protocol) 서버입니다.

개요

Ankr MCP 서버는 Ankr API를 통해 온체인 데이터를 가져옵니다. MCP를 구현하여 LLM이 20개 이상의 체인에서 블록체인 데이터를 쿼리할 수 있도록 합니다.

Related MCP server: Base Network MCP Server

기능

이 서버는 모든 Ankr Advanced API 카테고리에 걸쳐 21개의 도구를 제공합니다:

토큰 작업

토큰 잔액 가져오기 (get_token_balances): 특정 블록체인에서 지갑의 모든 토큰 잔액을 가져옵니다.
통화 가져오기 (get_currencies): 블록체인에서 사용 가능한 모든 통화를 나열합니다.
토큰 가격 가져오기 (get_token_price): 모든 토큰의 현재 USD 가격을 가져옵니다.
토큰 보유자 가져오기 (get_token_holders): 토큰의 보유자 주소를 나열합니다.
토큰 보유자 수 가져오기 (get_token_holders_count): 과거 보유자 수 데이터를 가져옵니다.
토큰 전송 내역 가져오기 (get_token_transfers): 주소에 대한 토큰 전송 내역을 가져옵니다.
토큰 가격 기록 가져오기 (get_token_price_history): 시간에 따른 과거 가격 데이터를 가져옵니다.
토큰 가격 설명 (explain_token_price): 토큰 가격이 어떻게 산출되는지 분석합니다.

NFT 작업

소유자별 NFT 가져오기 (get_nfts_by_owner): 지갑이 소유한 모든 NFT를 가져옵니다.
NFT 메타데이터 가져오기 (get_nft_metadata): 특정 NFT의 메타데이터(이름, 이미지, 특성)를 가져옵니다.
NFT 보유자 가져오기 (get_nft_holders): NFT 컬렉션의 모든 보유자를 가져옵니다.
NFT 전송 내역 가져오기 (get_nft_transfers): NFT 전송 내역을 가져옵니다.

쿼리 작업

블록체인 통계 가져오기 (get_blockchain_stats): 체인 통계(트랜잭션, 블록 시간 등)를 가져옵니다.
블록 가져오기 (get_blocks): 블록 범위에 대한 전체 블록 데이터를 가져옵니다.
로그 가져오기 (get_logs): 과거 이벤트 로그 데이터를 가져옵니다.
해시로 트랜잭션 가져오기 (get_transactions_by_hash): 해시로 트랜잭션을 조회합니다.
주소로 트랜잭션 가져오기 (get_transactions_by_address): 주소에 대한 모든 트랜잭션을 가져옵니다.
상호작용 가져오기 (get_interactions): 지갑이 상호작용한 모든 체인을 나열합니다.
과거 계정 잔액 가져오기 (get_account_balance_historical): 과거 블록 높이에서의 잔액을 가져옵니다.
블록별 내부 트랜잭션 가져오기 (get_internal_transactions_by_block): 블록 내의 내부 트랜잭션을 가져옵니다.
부모 해시로 내부 트랜잭션 가져오기 (get_internal_transactions_by_parent_hash): 부모 트랜잭션으로부터 내부 트랜잭션을 가져옵니다.

설치

npm install @akki91/ankr-mcp

사용법

환경 설정

ANKR API 문서 포털에 로그인하여 ANKR API 토큰을 설정하세요.

export ANKR_API_TOKEN=your_api_token_here

서버 실행

서버는 명령줄에서 직접 실행할 수 있습니다:

npx @akki91/ankr-mcp

LLM 도구와 함께 사용

이 서버는 MCP(Model Context Protocol)를 구현하여 호환되는 AI 모델의 도구 제공자로 사용할 수 있습니다.

AI 모델과의 통합

MCP를 지원하는 AI 애플리케이션과 이 서버를 통합하려면 앱의 서버 구성에 다음을 추가하세요:

{
  "mcpServers": {
    "ankr-mcp": {
      "command": "npx",
      "args": [
        "@akki91/ankr-mcp"
      ],
      "env": {
        "ANKR_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Claude Desktop에서 Ankr MCP 도구 통합하기

아래 지침에 따라 설정을 업데이트하고 Claude Desktop 내에서 MCP 서버를 사용할 수 있도록 하세요.

1단계: Claude Desktop에서 설정 액세스

Claude Desktop을 실행합니다.
메인 메뉴에서 **Settings(설정)**로 이동합니다.

2단계: 개발자 설정 업데이트

**Developer Settings(개발자 설정)**를 엽니다.
MCP 서버 정의가 포함된 구성 파일을 편집합니다.
MCP 서버가 이미 나열되어 있다면 기존 목록에 Ankr MCP 구성을 추가합니다. 그렇지 않으면 위 전체 구성을 복사하여 붙여넣으세요.

3단계: Claude Desktop 재시작

Developer Settings 메뉴를 닫습니다.
Claude Desktop을 재시작하여 변경 사항을 적용합니다.

4단계: 통합 확인

Claude Desktop이 재시작되면 채팅 프롬프트 바로 아래에 있는 도구 아이콘을 클릭합니다.
Ankr MCP 서버에서 제공하는 도구 목록이 표시되고 액세스 가능한지 확인합니다.

이 단계를 따르면 Ankr MCP 구성이 Claude Desktop에 통합되어 인터페이스를 통해 직접 도구에 액세스할 수 있게 됩니다.

샘플 채팅 프롬프트

Claude 또는 호환되는 AI에서 이 MCP 서버와 함께 사용할 수 있는 프롬프트 예시입니다:

토큰 쿼리

What are the token balances for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum?

What's the current price of USDC on Ethereum?

Show me the price history of ETH over the last 30 days.

How many holders does the LINK token have on Ethereum?

Show me recent token transfers for vitalik.eth on Polygon.

NFT 쿼리

What NFTs does 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 own?

Get me the metadata for Bored Ape #1234.

Who holds NFTs from the CryptoPunks collection?

Show me recent NFT transfers for this wallet on Ethereum.

블록체인 및 트랜잭션 쿼리

What are the current stats for Ethereum and Polygon?

Which blockchains has wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 interacted with?

Look up transaction 0x1234abcd... and decode the logs.

Show me the latest blocks on Arbitrum with transactions included.

What were the internal transactions in Ethereum block 19000000?

What was my wallet balance at block 17000000?

개발

소스에서 빌드하기

# Clone the repository
git clone https://github.com/akki91/ankr-mcp.git
cd ankr-mcp

# Install dependencies
npm install

# Build the project
npm run build

테스트 실행

npm test

디버그 모드

이 프로젝트의 디버깅은 MCP Inspector를 사용하여 지원됩니다.

npm run debug

출처

이 프로젝트는 여기에서 생성된 서버 목록에서 영감을 받았습니다.

Ankr API MCP Server