BlockRunAI/blockrun-mcp

Live data for AI agents — search, research, markets, crypto, X/Twitter. Pay-per-call via x402 micropayments.

BlockRun MCP – AI 에이전트를 위한 호출당 지불 방식의 실시간 데이터 및 작업 서버

무엇인가요

  • TypeScript/Node로 작성된 오픈소스 Model Context Protocol (MCP) 서버로, 어떤 MCP 호환 LLM 에이전트 (Claude, Codex, Cursor, VS Code 등)에도 연결할 수 있습니다.
  • 다음과 같은 19개의 즉시 사용 가능한 도구를 제공합니다:
    • 실시간 시장 데이터 및 Polymarket에서 USDC로 정산되는 실제 베팅 가능.
    • 웹, X (이전의 Twitter), 학술 검색.
    • 이미지, 비디오, 오디오 생성.
    • 약 40개의 블록체인 (Solana, Base 등)에서의 체인 내 쿼리.
    • LLM 모델 접근, 가격 피드, DEX 데이터 등.
  • 도구들은 에이전트 네이티브입니다: LLM은 인간이 작성한 연결 코드 없이도 프롬프트에서 직접 도구를 호출할 수 있습니다.

결제 방식

  • 지갑 모드 (기본) – 첫 실행 시 자동으로 자체 보관 지갑이 생성됩니다. Solana 또는 Base에서 USDC를 입금하고, 각 도구 호출은 x402 마이크로결제 프로토콜을 통해 체인 내에서 정산됩니다 (센트의 일부분 + 미미한 네트워크 수수료).
  • API 키 모드 – 팀이 지갑 대신 사전 결제된 크레딧 계정을 선호하는 경우 BLOCKRUN_API_KEY를 설정하세요 ( user.blockrun.ai에서 획득). 사용량 기반 정확한 청구, 호출당 수수료 없음.
  • 두 모드 모두 동일한 19개의 도구를 제공하며, 언제든지 전환 가능합니다.

에이전트에게 왜 중요한가요

  • 기존 데이터 API는 인간이 계정을 생성하고 API 키를 저장하며 신용카드 청구를 관리해야 하는 단계를 필요로 합니다 – 이는 자율적인 LLM이 수행할 수 없는 작업입니다.
  • BlockRun은 이러한 모든 소스를 단일 인증 원칙 (지갑 서명 또는 API 키) 뒤에 통합하고, 호출당 지불 방식으로 전환하여 진정한 자율 에이전트를 가능하게 합니다.
  • 또한 사람이 중간에 개입하는 지출 승인 (BLOCKRUN_CONFIRM_SPEND=on)을 지원하여, 예산을 초과하는 모든 유료 호출에 대해 사용자가 승인하거나 거부할 수 있습니다.

설치 및 사용법

  1. MCP 서버 설치 (Claude Code를 통해 추천):
    claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest
    
    이 명령어는 첫 실행 시 지갑을 생성하며, 약 5 USDC를 입금하거나 API 키를 설정하세요.
  2. 도구 프로필 선택 (선택 사항) – 모델 컨텍스트에 로드되는 스키마 데이터 양을 줄입니다. 예시:
    • full – 모든 19개 도구 (기본값, 턴당 약 12.6 K 토큰).
    • trading – 시장 데이터 및 Polymarket 거래용 8개 도구 (~5.2 K 토큰).
    • media, research, chat – 더 작은 하위 집합. --profile <name> 또는 BLOCKRUN_MCP_PROFILE을 설정하세요.
  3. 자금 추가
    • 지갑: ~/.blockrun/.session에 표시된 주소로 USDC를 송금하세요.
    • API 키: BlockRun 대시보드에서 키를 획득하고 BLOCKRUN_API_KEY로 내보내세요.
  4. 어떤 MCP 호환 클라이언트에서든 도구 호출. 예시 (Claude):
    {"name":"blockrun_polymarket","input":{"question":"이해에서 비트코인이 10만 달러에 도달할까요?"}}
    
    서버는 실시간 배당률을 반환하며, blockrun_polymarket을 사용하면 베팅도 가능합니다.

지원되는 클라이언트 (모두 npx를 통해 서버를 시작할 수 있음):

  • Claude Code (검증됨), Codex CLI, OpenClaw, Claude Desktop, Cursor, VS Code Copilot, Gemini CLI, Grok, Windsurf 등.
  • 각 클라이언트는 npx -y @blockrun/mcp@latest를 가리키는 작은 JSON 조각으로 구성할 수 있습니다.

주요 기능

  • 한 개의 지갑, 여러 출처 – 각 공급자별 등록이 필요 없음.
  • x402를 통한 USDC로 호출당 지불, 또는 API 키를 통한 사전 결제 크레딧.
  • 읽기 + 실행 – 도구는 단순히 데이터를 가져오는 것뿐만 아니라 Polymarket에서 실제 거래를 실행할 수 있음.
  • 예산 보호를 위한 사람이 중간에 개입하는 지출 대화.
  • 생성형 UI – Claude Desktop과 VS Code에서는 Polymarket 도구가 상호작용 가능한 주문 카드를 표시하고, 지갑 도구는 잔액과 QR 코드를 표시합니다.
  • 오픈소스 MIT 라이선스 – 서버 코드는 npm (@blockrun/mcp)과 GitHub에 게시되어 있습니다.

누가 사용할 수 있을까

  • 실시간 시장, 웹, 또는 블록체인 데이터가 필요한 자율 에이전트를 개발하는 개발자.
  • LLM 기반 거래나 예측 시장 봇을 실험하는 연구자.
  • 수십 개의 API 키를 관리하지 않고도 여러 에이전트를 위한 통합된 자체 보관 데이터 계층을 원하는 팀.

결론: BlockRun MCP는 LLM에 단일 호출당 지불 게이트웨이를 제공함으로써, 실시간 데이터와 실제 세계 거래 기능을 갖춘 완전한 에이전트로 전환합니다. 이 게이트웨이는 19개의 실시간 도구(실제 USDC로 Polymarket에 베팅할 수 있는 기능 포함)에 접근할 수 있게 하며, 인증은 간단하게 지갑 서명 또는 API 키로, 비용은 투명하게 유지됩니다.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트