파운드리 MCP 서버

Foundry 툴체인(Forge, Cast, Anvil)을 사용하여 Solidity 개발 기능을 제공하는 간단하고 가볍고 빠른 MCP(Model Context Protocol) 서버입니다.

개요

이 서버는 LLM 어시스턴트를 Foundry 생태계에 연결하여 다음과 같은 작업을 수행할 수 있도록 합니다.

노드(로컬 Anvil 인스턴스 또는 원격 RPC 엔드포인트)와 상호 작용합니다.
스마트 계약 및 블록체인 데이터 분석
Cast를 사용하여 일반적인 EVM 작업 수행
Solidity 코드 및 스크립트를 관리, 배포 및 실행합니다.
영구적인 Forge 작업 공간으로 작업

특징

네트워크 상호 작용

로컬 Anvil 인스턴스 시작 및 관리
원격 네트워크에 연결(RPC만 지정)
네트워크/체인 정보 가져오기

계약 상호작용

계약 함수 호출(읽기 전용)
계약에 거래 보내기( PRIVATE_KEY 구성된 경우)
거래 영수증 받기
계약서 보관함 읽기
거래 추적 분석
블록 탐색기에서 계약 ABI 및 소스 검색

솔리디티 개발

전담 Forge 작업 공간 유지
Solidity 파일 생성 및 편집
종속성 설치
Forge 스크립트 실행
계약 배포

유틸리티 함수

계약 주소 계산
계약 바이트코드 크기 확인
가스 비용 추정
단위 간 변환(16진수에서 소수로 등)
지갑 생성
이벤트 로그 가져오기
조회 함수 및 이벤트 시그니처

용법

이 서버는 MCP 클라이언트를 위한 MCP 도구 제공자로 사용되도록 설계되었습니다. 클라이언트에 연결되면 클라이언트(Claude Desktop, Cursor, Client 등)가 Solidity 및 온체인 작업을 직접 수행할 수 있습니다.

요구 사항

Node.js v18+
Foundry 툴체인 (Forge, Cast, Anvil)

수동 설정

시스템에 주조 도구(Forge, Cast, Anvil)가 설치되어 있는지 확인하세요.지엑스피1
서버를 복제하고 빌드합니다.
bun i && bun build
클라이언트 구성을 업데이트하세요(예: Claude 데스크톱):

 "mcpServers": {
    "foundry": {
      "command": "node",
      "args": [
        "path/to/foundry-mcp-server/dist/index.js"
      ],
      "env" :{
        "PRIVATE_KEY": "0x1234",
      }
    }
 }

[!NOTE] PRIVATE_KEY 는 선택 사항입니다.

NPM 패키지를 사용하여 설정

곧 출시 예정

구성

서버는 다음과 같은 환경 변수를 지원합니다.

RPC_URL : 아무것도 지정되지 않은 경우 사용할 기본 RPC URL(선택 사항)
PRIVATE_KEY : 거래에 사용할 개인 키(선택 사항)

[!주의] 메인넷 자금이 포함된 키를 추가하지 마십시오. 코드에서 안전하게 사용하더라도 LLM은 환각을 일으키고 악의적인 거래를 전송할 수 있습니다. 테스트/개발 목적으로만 사용하십시오. LLM을 절대 신뢰하지 마십시오!

작업 공간

서버는 모든 Solidity 파일, 스크립트 및 종속성에 대한 ~/.mcp-foundry-workspace 에 영구적인 Forge 작업 공간을 유지 관리합니다.

도구

모루

anvil_start : 새로운 Anvil 인스턴스를 시작합니다
anvil_stop : 실행 중인 Anvil 인스턴스를 중지합니다.
anvil_status : Anvil이 실행 중인지 확인하고 상태를 가져옵니다.

깁스

cast_call : 계약 함수 호출(읽기 전용)
cast_send : 계약 함수에 트랜잭션을 보냅니다.
cast_balance : 주소의 ETH 잔액을 확인합니다.
cast_receipt : 거래 영수증을 받습니다.
cast_storage : 특정 슬롯의 계약 저장소를 읽습니다.
cast_run : 로컬 환경에서 게시된 트랜잭션을 실행합니다.
cast_logs : 서명 또는 주제별 로그 가져오기
cast_sig : 함수 또는 이벤트 시그니처에 대한 선택기를 가져옵니다.
cast_4byte : 4byte 디렉토리에서 조회 함수 또는 이벤트 시그니처
cast_chain : 현재 체인에 대한 정보를 가져옵니다.

노

forge_script : 작업 공간에서 Forge 스크립트를 실행합니다.
install_dependency : Forge 작업 공간에 대한 종속성을 설치합니다.

파일 관리

create_solidity_file : 작업 공간에 Solidity 파일을 생성하거나 업데이트합니다.
read_file : 작업 공간에서 파일의 내용을 읽습니다.
list_files : 작업 공간에 있는 파일 목록

유용

convert_eth_units : EVM 단위(wei, gwei, hex) 간 변환
compute_address : 배포될 계약의 주소를 계산합니다.
contract_size : 배포된 계약의 바이트코드 크기를 가져옵니다.
estimate_gas : 거래의 가스 비용을 추정합니다.

Claude 데스크톱 앱에서의 사용법 🎯

설치가 완료되고 Claude 데스크톱 앱 구성이 완료되면 Claude 데스크톱 앱을 완전히 닫았다가 다시 열어야 tavily-mcp 서버를 확인할 수 있습니다. 앱 왼쪽 하단에 사용 가능한 MCP 도구를 나타내는 망치 아이콘이 표시되며, 이 아이콘을 클릭하면 사용 가능한 도구에 대한 자세한 내용을 볼 수 있습니다.

이제 Claude는 Foundry-MCP 서버에 대한 완전한 접근 권한을 갖게 됩니다. 아래 예제를 Claude 데스크톱 앱에 삽입하면 Foundry-MCP 서버 도구가 작동하는 모습을 볼 수 있습니다.

예시

거래 분석 :

Can you analyze the transaction and explain what it does? 
https://etherscan.io/tx/0xcb73ad3116f19358e2e649d4dc801b7ae0590a47b8bb2e57a8e98b6daa5fb14b

잔액 조회 :

Query the mainnet ETH and USDT balances for the wallet 0x195F46025a6926968a1b3275822096eB12D97E70.

거래 전송 :

Transfer 0.5 USDC to 0x195F46025a6926968a1b3275822096eB12D97E70 on Mainnet. 

계약 배포/스크립트 실행 :

Deploy a mock ERC20 contract to a local anvil instance and name it "Fire Coin".

감사의 말 ✨

MCP 사양을 위한 모델 컨텍스트 프로토콜
클로드 데스크탑을 위한 인류학

부인 성명

본 소프트웨어는 있는 그대로 제공됩니다. 소프트웨어의 안전성이나 정확성에 대해 명시적이든 묵시적이든 어떠한 보장, 진술 또는 보증도 하지 않습니다. 본 소프트웨어는 감사를 거치지 않았으므로 의도한 대로 작동할 것이라는 보장은 없으며, 사용자는 지연, 실패, 오류, 누락, 전송된 정보 손실 또는 자금 손실을 경험할 수 있습니다. 개발자는 상기 내용에 대해 어떠한 책임도 지지 않습니다. 사용자는 신중하게 진행해야 하며, 모든 책임은 사용자에게 있습니다.

Foundry MCP Server

Integrations