TapTools API MCP

TapTools API 에 대한 액세스를 제공하는 Python 기반 MCP(Model Context Protocol) 서버로, Claude 또는 GPT와 같은 대규모 언어 모델(LLM)이 Cardano 관련 데이터(토큰, NFT, 시장 정보 등)를 가져올 수 있도록 합니다. 이 서버는 TapTools API 작업을 MCP "도구"로 표준화하여 AI 워크플로에 쉽게 통합할 수 있도록 합니다.

특징

• 비동기 구현 : 비차단 IO를 위해 최신 Python 비동기 패턴과 httpx를 사용합니다.
• 보안 인증 : 환경 변수나 .env 파일에서 TAPTOOLS_API_KEY 읽습니다.
• MCP 지원 : MCP 호환 클라이언트에서 접근 가능한 "도구"로 TapTools 기능을 제공합니다.
• 토큰 운영 : 가격, 상위 토큰, 시가총액 데이터, 거래량 통계 등.
• NFT 운영 : NFT 수집 통계, 거래, 상장, 배포 등
• 시장 데이터 : 거래량, 주소, 보유자 등에 대한 집계된 통계입니다.
• 통합 및 온체인 : 온체인 데이터, 블록 정보, 이벤트, DEX 쌍 등에 대한 액세스
• 지갑 데이터 : 포트폴리오 포지션, 토큰/NFT 보유량, 거래 내역, 거래.

빠른 시작

1. 저장소를 복제합니다 .지엑스피1
2. 가상 환경을 만들고 활성화합니다 .
   python3 -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
3. 종속성 설치 :
   pip install -e .
4. TapTools API 키를 설정하세요 :
   • 옵션 A : .env 파일에 추가:
     TAPTOOLS_API_KEY=your-real-taptools-api-key
   • 옵션 B : 환경 변수 설정:
     export TAPTOOLS_API_KEY="your-real-taptools-api-key"
5. MCP 서버를 실행합니다 .
   python -m taptools_api_mcp
   기본적으로 MCP 통합을 위해 표준 입출력(stdio)에서 실행됩니다.
6. 연결 테스트 (선택 사항):
   python test_connection.py

사용 예

MCP 클라이언트(예: mcp Python CLI 도구)가 있는 경우 서버를 시작하고 사용 가능한 도구를 호출할 수 있습니다.

mcp cli 에 들어가면 다음과 같은 도구를 호출할 수 있습니다.

이렇게 하면 TapTools API 키가 유효하고 접근 가능한지 확인할 수 있습니다.

또는 예를 들어 토큰 시가총액 정보를 얻으려면:

토큰의 시가총액, 가격, 공급량 등이 포함된 JSON 데이터를 받아야 합니다.

API 문서: MCP 도구

사용 가능한 MCP 도구, 매개변수 및 간략한 설명 목록은 다음과 같습니다. 이러한 도구는 올바른 JSON 페이로드를 사용하여 호출해야 합니다. 모든 JSON 요청은 src/taptools_api_mcp/models/ 에 있는 Pydantic 모델과 일치해야 합니다.

1. verify_connection

• 설명 : TapTools API 인증을 확인합니다.
• 매개변수 : (매개변수 없음.)
• 샘플 사용 :
  { }

2. get_token_mcap

• 설명 : 토큰 시가총액 정보를 얻습니다.
• 매개변수 ( TokenMcapRequest ):
  { "unit": "string" // required: token unit identifier }
• 샘플 사용 :
  { "unit": "lovelace" }

3. get_token_holders

• 설명 : 토큰 보유자의 총 수를 가져옵니다.
• 매개변수 ( TokenHoldersRequest ):
  { "unit": "string" // required: token unit identifier }
• 샘플 사용 :
  { "unit": "lovelace" }

4. get_token_holders_top

• 설명 : 최고의 토큰 보유자를 확보하세요.
• 매개변수 ( TokenTopHoldersRequest ):
  { "unit": "string", // required "page": "number", // optional (default 1) "per_page": "number"// optional (default 20) }
• 샘플 사용 :
  { "unit": "some_token_unit", "page": 1, "per_page": 5 }

5. get_nft_asset_sales

• 설명 : NFT 자산 판매 내역을 가져옵니다.
• 매개변수 ( NFTAssetSalesRequest ):
  { "policy": "string", // required: NFT policy ID "name": "string" // optional: NFT name }
• 샘플 사용 :
  { "policy": "abc123polid", "name": "coolNFT" }

6. get_nft_collection_stats

• 설명 : NFT 수집 통계를 받으세요.
• 매개변수 ( NFTCollectionStatsRequest ):
  { "policy": "string" // required: NFT collection policy ID }
• 샘플 사용 :
  { "policy": "abc123polid" }

7. get_market_stats

• 설명 : 시장 전체의 통계를 얻습니다.
• 매개변수 ( MarketStatsRequest ):
  { "quote": "string" // optional, default "ADA" }
• 샘플 사용 :
  { "quote": "USD" }

8. get_integration_asset

• 설명 : ID(통합 엔드포인트)로 자산 세부 정보를 가져옵니다.
• 매개변수 ( IntegrationAssetRequest ):
  { "id": "string" // required: ID of the asset }
• 샘플 사용 :
  { "id": "asset123abc" }

9. get_asset_supply

• 설명 : 온체인 자산 공급을 받으세요.
• 매개변수 ( AssetSupplyRequest ):
  { "unit": "string" // required: token unit identifier }
• 샘플 사용 :
  { "unit": "lovelace" }

10. get_wallet_portfolio

• 설명 : 지갑 포트폴리오 포지션을 가져옵니다.
• 매개변수 ( WalletPortfolioPositionsRequest ):
  { "address": "string" // required: wallet address }
• 샘플 사용 :
  { "address": "addr1xyz..." }

(필요한 경우 토큰, NFT, 온체인 등에 대한 추가 엔드포인트를 동일한 형식으로 추가할 수 있습니다. 가능한 요청에 대한 자세한 내용은 src/taptools_api_mcp/models/ 폴더를 참조하세요.)

전개

AWS ECS, Azure Container Instances 또는 Google Cloud Run과 같은 서비스에서 이 Python MCP 서버를 컨테이너화하거나 호스팅할 수 있습니다. TAPTOOLS_API_KEY 비밀로 안전하게 저장하세요. Docker 기반 배포의 경우:

참고 : MCP 사양에 따라 서버는 기본적으로 stdio를 수신합니다. 고급 배포 또는 사용자 지정 통합의 경우, 환경에 따라 server.py 소켓과 같은 대체 전송 방식과 함께 실행되도록 조정할 수 있습니다.