웹3 MCP

솔라나, 이더리움, THORChain, XRP Ledger, TON(The Open Network), Cardano, UTXO 체인 등 여러 블록체인과 상호 작용하기 위한 모델-컨텍스트-프로토콜 서버입니다. 이 서버는 일반적인 블록체인 작업에 대한 간단한 RPC 엔드포인트를 제공하여 환경 변수를 통해 다양한 블록체인과 안전하게 상호 작용할 수 있도록 합니다.

특징

솔라나 운영:

• SOL 계좌 잔액 확인

• 자세한 계정 정보를 얻으세요

• 계정 간 SOL 전송

• SPL 토큰 잔액 보기

• 개인 키에서 지갑 주소를 가져옵니다

• Jupiter를 사용하여 토큰 스왑(모든 Solana DEX에서 가장 저렴한 라우팅)

이더리움 및 EVM 체인 운영:

• 여러 네트워크에서 네이티브 토큰 잔액을 확인하세요

• ERC-20 토큰 잔액 확인

• 네이티브 토큰 보내기(.env의 개인 키 사용)

• ERC-20 토큰 보내기(.env의 개인 키 사용)

• ERC-20 토큰 지출 승인(.env의 개인 키 사용)

카르다노 운영:

• 네트워크 정보 및 통계 가져오기

• 주소 잔액 및 거래 내역 확인

• 주소에 대한 UTxO 보기

• 스테이크 풀과 위임 정보 살펴보기

• 네이티브 자산에 대한 세부 정보 얻기

• 자세한 거래 정보 보기

• 현재 시대에 대한 통계를 얻으세요

THORChain 운영:

• RUNE 잔액 확인

• 자세한 풀 정보를 얻으세요

• 지원되는 모든 자산 간 스왑 견적을 받으세요

• THORChain 프로토콜을 통한 크로스 체인 스왑

UTXO 체인 작업:

• 비트코인(BTC)

  • 주소 잔액 확인

  • 거래 내역 보기

  • 주소 확인

  • 네트워크 정보 및 수수료 받기

• 라이트코인(LTC)

  • 주소 잔액 확인

  • 거래 내역 보기

  • 주소 확인

  • 네트워크 정보 및 수수료 받기

• 도지코인(DOGE)

  • 주소 잔액 확인

  • 거래 내역 보기

  • 주소 확인

  • 네트워크 정보 및 수수료 받기

• 비트코인 캐시(BCH)

  • 주소 잔액 확인

  • 거래 내역 보기

  • 주소 확인

  • 네트워크 정보 및 수수료 받기

XRP 원장 작업:

• XRP 계좌 잔액 확인

• 거래 내역 보기

• XRP 주소 검증

• XRP를 다른 주소로 보내세요

• 현재 XRP Ledger 정보를 받으세요

• 토큰 잔액 확인

• 토큰에 대한 신뢰 라인 생성

TON(The Open Network) 운영:

• TON 계좌 잔액을 확인하세요

• 거래 내역 보기

• TON 주소 검증

• 선택 사항인 메모/코멘트와 함께 TON을 다른 주소로 보내세요.

• 현재 TON 네트워크 정보를 얻으세요

지원되는 EVM 네트워크:

• 이더리움

• 베이스

• 중재

• 낙천주의

• BSC(바이낸스 스마트 체인)

• 다각형

• 눈사태

• 베라체인

Related MCP server: AMOCA Solana MCP Server

설정

1. 종속성을 복제하고 설치합니다.

지엑스피1

2. 루트 디렉토리에 .env 파일을 만듭니다.

cp .env.example .env

3. .env에서 환경 변수를 구성하세요.

필수 구성

# Tool Registration Controls
ENABLE_SOLANA_TOOLS=true      # Enable/disable Solana tools
ENABLE_ETHEREUM_TOOLS=true    # Enable/disable Ethereum and EVM chain tools
ENABLE_CARDANO_TOOLS=true     # Enable/disable Cardano tools

# UTXO Chain Tools
ENABLE_BITCOIN_TOOLS=true     # Enable/disable Bitcoin tools
ENABLE_LITECOIN_TOOLS=true    # Enable/disable Litecoin tools
ENABLE_DOGECOIN_TOOLS=true    # Enable/disable Dogecoin tools
ENABLE_BITCOINCASH_TOOLS=true # Enable/disable Bitcoin Cash tools
ENABLE_THORCHAIN_TOOLS=true   # Enable/disable THORChain tools
ENABLE_RIPPLE_TOOLS=true      # Enable/disable XRP Ledger tools
ENABLE_TON_TOOLS=true         # Enable/disable TON tools

# Private Keys (required for transactions)
ETH_PRIVATE_KEY=your-ethereum-private-key
SOLANA_PRIVATE_KEY=your-base58-encoded-solana-private-key

# XRP Ledger credentials (required for XRP transactions)
# Either private key or mnemonic is required
XRP_PRIVATE_KEY=your-xrp-private-key-in-hex
# OR
XRP_MNEMONIC=your-xrp-mnemonic-recovery-phrase
# Optional - used to verify the derived address
XRP_ADDRESS=your-xrp-account-address

# TON Configuration
TON_MNEMONIC=word1 word2 word3 ... word24  # 24-word recovery phrase for TON wallet
TON_ADDRESS=your-ton-wallet-address       # Your TON wallet address
TON_API_KEY=your-toncenter-api-key        # Get from @tonapibot on Telegram (optional but recommended)
TON_RPC_URL=https://toncenter.com/api/v2/jsonRPC  # Optional - default is TON Center API

# Cardano Configuration
BLOCKFROST_API_KEY=your-blockfrost-api-key  # Get a real API key from https://blockfrost.io/
CARDANO_NETWORK=mainnet     # or 'testnet', 'preview', 'preprod'
CARDANO_MNEMONIC=your-cardano-mnemonic-phrase   # Required for transaction signing
CARDANO_ACCOUNT_INDEX=0     # Optional - defaults to 0

선택적 구성

# Network RPC URLs (optional - will use public endpoints if not specified)
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com

# Ethereum & Layer 2s
ETH_RPC_URL=https://eth-mainnet.g.alchemy.com/v2/your-api-key
ARBITRUM_RPC_URL=https://arb1.arbitrum.io/rpc
BASE_RPC_URL=https://mainnet.base.org
OPTIMISM_RPC_URL=https://mainnet.optimism.io

# Other EVM Chains
BSC_RPC_URL=https://bsc-dataseed.binance.org
POLYGON_RPC_URL=https://polygon-rpc.com
AVALANCHE_RPC_URL=https://api.avax.network/ext/bc/C/rpc
BERACHAIN_RPC_URL=https://rpc.berachain.com

# XRP Ledger
XRP_RPC_URL=https://xrplcluster.com/     # Optional - will use public endpoint if not specified

# TON Network
TON_RPC_URL=https://toncenter.com/api/v2/jsonRPC  # Optional - default is TON Center API
TON_API_KEY=your-toncenter-api-key        # Get from @tonapibot on Telegram (optional but recommended)

# THORChain Configuration
THORCHAIN_NODE_URL=https://thornode.ninerealms.com  # Optional - will use public endpoint if not specified
THORCHAIN_PRIVATE_KEY=your-thorchain-private-key
THORCHAIN_MNEMONIC=your-thorchain-mnemonic

# UTXO Chain API Keys (optional)
BLOCKCYPHER_API_KEY=your-blockcypher-api-key
SOCHAIN_API_KEY=your-sochain-api-key

4. 도구 빌드:

npm run build

5. claude_desktop_config.json에 도구를 추가하세요.

{
  "mcpServers": {
    "web3-rpc": {
      "command": "node",
      "args": [
        "/PATH/TO/web3-mcp/build/index.js"
      ]
    }
  }
}

도구 등록

Web3 MCP 서버를 사용하면 환경 변수를 통해 어떤 블록체인 도구가 등록되는지 제어할 수 있습니다.

• ENABLE_SOLANA_TOOLS : Solana 도구 활성화/비활성화

• ENABLE_ETHEREUM_TOOLS : Ethereum 및 EVM 체인 도구 활성화/비활성화

• ENABLE_BITCOIN_TOOLS : 비트코인 도구 활성화/비활성화

• ENABLE_LITECOIN_TOOLS : Litecoin 도구 활성화/비활성화

• ENABLE_DOGECOIN_TOOLS : Dogecoin 도구 활성화/비활성화

• ENABLE_BITCOINCASH_TOOLS : 비트코인 캐시 도구 활성화/비활성화

• ENABLE_THORCHAIN_TOOLS : THORChain 도구 활성화/비활성화

• ENABLE_RIPPLE_TOOLS : XRP Ledger 도구 활성화/비활성화

• ENABLE_CARDANO_TOOLS : Cardano 도구 활성화/비활성화

• ENABLE_TON_TOOLS : TON 도구 활성화/비활성화

.env 파일에서 이 변수를 true 또는 false 로 설정하여 서버에서 사용할 수 있는 도구를 제어하세요. 이를 통해 다음을 수행할 수 있습니다.

• 필요한 도구만 로딩하여 시작 시간을 단축합니다.

• 사용하지 않는 체인을 비활성화하여 보안 표면 영역을 최소화합니다.

• 특정 사용 사례에 맞게 서버를 사용자 정의하세요

• 활성 연결을 제한하여 리소스 사용을 제어합니다.

사용 예

클로드(또는 원하는 MCP 클라이언트)에게 물어보세요:

Solana 작업(ENABLE_SOLANA_TOOLS=true인 경우)

• "내 Solana 주소는 무엇입니까?" - .env의 개인 키에서 파생된 주소를 보여줍니다.

• "62QXuWZ3WT6ws1ZFxJobVDVXn6bEsiYpLo5yG612U6u3의 잔액은 얼마입니까?"

• "0.001 SOL을 Cg6cVS4tjkxHthm3K9BHhmvqF7kSz8GnXqqYXnHBzGXd로 전송"

• "내 SPL 토큰 잔액을 보여주세요"

• "0.1 SOL을 USDC로 교환"(최상의 가격 라우팅을 위해 Jupiter 사용)

EVM 작업(ENABLE_ETHEREUM_TOOLS=true인 경우)

• "0x556437c4d22ceaeeebf82006b85bdcc0ae67d933의 ETH 잔액은 얼마입니까?"

• "이더리움에서 0x556437c4d22ceaeeebf82006b85bdcc0ae67d933의 USDC 잔액을 확인하세요"

• "0x556437c4d22ceaeeebf82006b85bdcc0ae67d933에 0.1 ETH를 보내세요"

• "Arbitrum의 현재 가스 가격은 얼마인가요?"

• "Polygon의 0x556437c4d22ceaeeebf82006b85bdcc0ae67d933으로 100 USDC를 보내세요"

Cardano 작업(ENABLE_CARDANO_TOOLS=true인 경우)

• 카르다노의 잔액을 얻으세요

• 지갑 정보 보기

• ADA를 다른 주소로 보내기

• 네이티브 토큰을 다른 주소로 보내기

비트코인 작업(ENABLE_BITCOIN_TOOLS=true인 경우)

• "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa의 BTC 잔액은 얼마입니까?"

• "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh의 거래 내역을 보여주세요"

• "이 비트코인 주소를 확인하세요: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"

Litecoin 작업(ENABLE_LITECOIN_TOOLS=true인 경우)

• "LM2WMpR1Rp6j3Sa59cMXMs1SPzj9eXpGc1의 LTC 잔액은 얼마입니까?"

• "이 라이트코인 주소에 대한 거래 내역을 보여주세요"

• "현재 라이트코인 네트워크 수수료는 얼마인가요?"

Dogecoin 작업(ENABLE_DOGECOIN_TOOLS=true인 경우)

• "이 DOGE 주소 잔액을 확인하세요: D8vFz4p1L37jdg47HXKtSHA5uYLYxbGgPD"

• "최근 도지코인 거래 내역 보여주세요"

• "현재 DOGE 네트워크 수수료는 얼마인가요?"

비트코인 캐시 작업(ENABLE_BITCOINCASH_TOOLS=true인 경우)

• "이 주소의 BCH 잔액은 얼마입니까?"

• "BCH 거래 내역을 보여주세요"

• "이 비트코인 캐시 주소를 검증하세요"

THORChain 작업(ENABLE_THORCHAIN_TOOLS=true인 경우)

• "thor13zpdckczd0jvyhwxmrwnpap8gmy9m5kk2gzum3의 RUNE 밸런스는 어떻게 되나요?"

• "BTC.BTC 풀 정보를 보여주세요"

• "0.1 BTC.BTC를 ETH.ETH로 스왑 견적을 받으세요"

XRP 원장 작업(ENABLE_RIPPLE_TOOLS=true인 경우)

• "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe의 XRP 잔액은 얼마입니까?"

• "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe의 거래 내역을 보여주세요"

• "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe는 유효한 XRP 주소인가요?"

• "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe에게 10 XRP 보내기"

• "현재 XRP Ledger 정보는 무엇입니까?"

• "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe에 대한 토큰 잔액을 보여주세요"

• "발급자 rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe를 사용하여 USD에 대한 신뢰 라인을 1000으로 생성"

TON 작업(ENABLE_TON_TOOLS=true인 경우)

• "EQAAFhjXzKuQ5N0c96nsdZQWATcJm909LYSaCAvWFQF8tvUZ의 TON 잔액은 얼마입니까?"

• "EQAAFhjXzKuQ5N0c96nsdZQWATcJm909LYSaCAvWFQF8tvUZ의 거래 내역을 보여주세요"

• "UQD0BRQt-QdIEbsjuRsMqzDlBkUAEfQixShDECoKEOXRc4eR은 유효한 TON 주소인가요?"

• "EQAAFhjXzKuQ5N0c96nsdZQWATcJm909LYSaCAvWFQF8tvUZ로 0.1톤 보내기"

• "0.01 TON을 UQD0BRQt-QdIEbsjuRsMqzDlBkUAEfQixShDECoKEOXRc4eR에게 'test payment'라는 코멘트와 함께 보내세요."

• "현재 TON 네트워크 정보는 무엇입니까?"

보안 참고 사항

1. 환경 변수 : 모든 개인 키는 .env 파일에 저장되며 대화 기록에 노출되지 않습니다.

2. 개인 키 : 소액의 자금이 포함된 테스트 지갑에만 사용하세요.

3. RPC 엔드포인트 : 더 나은 안정성과 속도 제한을 위해 .env 파일에서 사용자 정의 RPC 엔드포인트를 구성할 수 있습니다.

4. .env 보안 : .env 파일은 개인 키의 우발적 노출을 방지하기 위해 git에서 자동으로 무시됩니다.

5. 도구 등록 : 도구 등록 컨트롤을 사용하여 필요한 체인만 활성화하여 보안 표면 영역을 최소화합니다.

고급 구성

사용자 정의 RPC 엔드포인트

.env 파일에서 사용자 지정 RPC 엔드포인트를 구성하여 안정성을 높이고 속도 제한을 높일 수 있습니다. 지정하지 않으면 도구는 공개 RPC 엔드포인트를 사용합니다.

네트워크 선택

EVM 작업의 경우, 네트워크 이름(ethereum, base, arbitrum, optimism, bsc, polygon, avalanche, berachain)을 지정할 수 있습니다. 도구는 자동으로 적절한 RPC 엔드포인트와 네트워크 구성을 사용합니다.

카르다노 구성

이 도구는 Blockfrost API와 Lucid 라이브러리를 사용하여 Cardano 블록체인과 상호 작용합니다.

• BLOCKFROST_API_KEY : 필수 - Blockfrost API 키( https://blockfrost.io/ 에서 등록)

• CARDANO_NETWORK : 선택 사항 - 사용할 Cardano 네트워크(메인넷, 테스트넷, 프리뷰, 사전 프로덕션). 기본값은 '메인넷'입니다.

• CARDANO_MNEMONIC : 거래에 필요 - Cardano 지갑의 니모닉 문구(15 또는 24단어)

• CARDANO_ACCOUNT_INDEX : 선택 사항 - 사용할 계정 인덱스(기본값은 0)

귀하의 니모닉에서 파생된 지갑은 거래에 서명하고 전송하는 데 사용됩니다.

THORChain 구성

이 도구는 기본적으로 Nine Realms 공개 엔드포인트를 사용하지만, 더 나은 안정성과 속도 제한을 위해 .env 파일에서 사용자 지정 THORChain 노드 URL을 구성할 수 있습니다.

XRP 원장 구성

이 도구는 XRP 거래에 개인 키 또는 니모닉 문구를 사용할 수 있습니다. .env 파일에서 다음 내용을 설정하세요.

• XRP_PRIVATE_KEY : 16진수 형식의 XRP 개인 키

• XRP_MNEMONIC : 개인 키의 대안 - 12단어 복구 문구

• XRP_ADDRESS : 선택 사항 - XRP 계정 주소(파생된 주소를 확인하는 데 사용됨)

• XRP_RPC_URL : 선택 사항 - 사용자 지정 XRP Ledger 노드 URL(기본값은 공개 엔드포인트)

TON 구성

이 도구는 기본적으로 TON Center의 API를 사용하며, TON 거래에 대한 니모닉 문구가 필요합니다. .env 파일에서 다음 내용을 설정하세요.

• TON_MNEMONIC : 필수 - TON 지갑에 대한 24단어 복구 문구

• TON_ADDRESS : 필수 - TON 지갑 주소

• TON_API_KEY : 권장 - Telegram의 @tonapibot의 API 키(더 높은 속도 제한을 위해)

• TON_RPC_URL : 선택 사항 - 사용자 지정 TON RPC URL(기본값은 TON Center API)

구현에는 속도 제한 처리를 위한 지수적 백오프를 갖춘 자동 재시도 논리가 포함됩니다.

UTXO 체인 데이터 제공자

이 도구는 UTXO 체인에 대해 여러 데이터 제공자를 사용합니다.

• 블록사이퍼

• 소체인

• 하스코인(비트코인 캐시용)

더 나은 속도 제한을 위해 .env 파일에서 이러한 공급자에 대한 API 키를 구성할 수 있습니다.

개발

도구를 수정하거나 확장하려면:

1. 소스 코드는 src 디렉토리에 있습니다.

2. src/chains 의 체인별 코드

3. 변경 사항을 적용한 후 npm run build 실행하세요.

4. 모든 새 코드에 TypeScript를 사용하세요

기여하다

기여를 환영합니다! 개선 사항이나 버그 수정 사항이 있으면 풀 리퀘스트를 제출해 주세요.

특허

ISC 라이센스