웹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(바이낸스 스마트 체인)
다각형
눈사태
베라체인

설정

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

지엑스피1

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

cp .env.example .env

.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

도구 빌드:

npm run build

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 네트워크 정보는 무엇입니까?"

보안 참고 사항

환경 변수 : 모든 개인 키는 .env 파일에 저장되며 대화 기록에 노출되지 않습니다.
개인 키 : 소액의 자금이 포함된 테스트 지갑에만 사용하세요.
RPC 엔드포인트 : 더 나은 안정성과 속도 제한을 위해 .env 파일에서 사용자 정의 RPC 엔드포인트를 구성할 수 있습니다.
.env 보안 : .env 파일은 개인 키의 우발적 노출을 방지하기 위해 git에서 자동으로 무시됩니다.
도구 등록 : 도구 등록 컨트롤을 사용하여 필요한 체인만 활성화하여 보안 표면 영역을 최소화합니다.

고급 구성

사용자 정의 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 키를 구성할 수 있습니다.

개발

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

소스 코드는 src 디렉토리에 있습니다.
src/chains 의 체인별 코드
변경 사항을 적용한 후 npm run build 실행하세요.
모든 새 코드에 TypeScript를 사용하세요

기여하다

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

특허

ISC 라이센스

Web3 MCP Server

Integrations