ethereum-tools

Claude MCP를 위한 Ethereum 도구

Claude AI 내에서 Model Context Protocol(MCP)을 사용하여 Ethereum 블록체인을 직접 분석할 수 있는 포괄적인 툴킷입니다.

특징

• 스마트 계약 감사 : 보안 문제에 대한 계약을 분석하고, 소스 코드를 검증하고, 토큰 표준을 감지합니다.
• 지갑 분석 : ETH 잔액, 토큰 보유량, 거래 내역 확인
• 수익성 추적 : 토큰 및 거래 전반에 걸친 지갑 수익/손실 계산
• 블록체인 데이터 : 간단한 명령으로 온체인 데이터를 가져오고 분석합니다.
• 토큰 분석 : 포괄적인 토큰 세부 정보, 가격 내역 및 거래 패턴을 확인하세요.

설치

필수 조건

• Node.js v16+
• 데스크톱용 클로드
• 무료 API 키:
  • Etherscan - 계약 검증 및 분석용
  • Moralis - 지갑 수익성 및 토큰 잔액
  • Codex - 토큰 가격 내역 및 고급 분석
  • (선택 사항) Infura 와 같은 RPC 공급자 또는 무료 공개 엔드포인트 사용

설정 단계

1. 이 저장소를 복제하세요:지엑스피1
2. 종속성 설치:
   npm install
3. 구성을 생성하세요:
   • mcp.json.example``mcp.json 으로 복사합니다.
   • API 키와 올바른 파일 경로를 포함하도록 mcp.json 편집하세요.
   { "mcpServers": { "ethereum-tools": { "command": "node", "args": ["YOUR_ABSOLUTE_PATH_TO/main.js"], "env": { "ETH_RPC_URL": "https://eth.llamarpc.com", "MORALIS_API_KEY": "your_moralis_api_key", "ETHERSCAN_API_KEY": "your_etherscan_api_key", "CODEX_API_KEY": "your_codex_api_key" } } } }
4. 데스크톱에 Claude 구성:
   • Windows에서: %APPDATA%\Claude\claude_desktop_config.json 생성/편집합니다.
   • mcp.json 파일의 내용을 이 구성에 복사하세요.

사용 가능한 도구

계약 분석

• auditContract(address: "0x...") : 스마트 계약에 대한 보안 감사를 수행합니다.

잔액 및 토큰

• getEthBalance(address: "0x...") : ETH 잔액을 가져옵니다.
• getTransactionCount(address: "0x...") : 거래 횟수(nonce)를 가져옵니다.
• getTokensBalance(address: "0x...", chain: "eth", excludeSpam: true) : 모든 토큰 잔액을 가져옵니다.

수익성

• getWalletPnl(address: "0x...", chain: "eth") : 지갑 수익/손실 분석

토큰 분석

• getTokenInfo(address: "0x...", networkId: 1) : 이름, 기호, 공급을 포함한 기본 토큰 정보를 가져옵니다.
• getTokenPriceHistory(address: "0x...", networkId: 1, days: 7, resolution: "1D") : 과거 가격 데이터 가져오기
• analyzeToken(address: "0x...", networkId: 1, days: 30) : 변동성 및 거래 패턴을 포함한 포괄적인 토큰 분석을 수행합니다.

유용

• add(a: 1, b: 2) : 간단한 유틸리티 함수 예제

문제 해결

일반적인 문제:

• 환경 변수를 찾을 수 없습니다 . mcp.json 에 API 키가 올바르게 설정되어 있는지 확인하세요.
• 공급자 오류 : ETH_RPC_URL이 유효하고 액세스 가능한지 확인하세요.
• 경로 오류 : Windows에서 적절한 이스케이프( \\ )를 사용하여 전체 절대 경로를 사용하고 있는지 확인하세요.
• Codex API 문제 : Codex API 키가 유효하고 토큰 데이터에 액세스할 수 있는 권한이 있는지 확인하세요.

개발

새로운 도구를 추가하려면:

1. tools/ 디렉토리에 파일을 생성하거나 수정합니다.
2. main.js 에 도구를 등록하세요
3. 변경 사항을 확인하려면 데스크톱용 Claude를 다시 시작하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.

감사의 말

• Anthropic의 모델 컨텍스트 프로토콜(MCP)
• 웹3.js
• 모랄리스
• 이더스캔
• 사본