모나드 MCP 서버

Name: Monad MCP Server
Author: Semutireng22

라이센스: MIT Node.js 버전

이 프로젝트는 Monad 테스트넷과의 원활한 상호작용을 위한 MCP 서버를 제공합니다. 블록체인 데이터(잔액, 거래 내역, 가스 가격, 블록) 쿼리와 코인플립 게임 플레이를 위한 CoinflipGame 스마트 컨트랙트와의 상호작용을 지원합니다. 이 서버는 Claude Desktop과 통합되어 사용자가 자연어로 명령을 실행할 수 있도록 지원합니다.

지원되는 기능 및 사용 방법

특징	설명	예제 명령
잔액 확인	Monad 테스트넷 주소의 MON 잔액을 확인하세요.	`check MON 0xa2e57a3A7744eA20B5E2848817e9D66C6cb9f765`
토큰 잔액 가져오기	특정 주소에 대한 특정 ERC-20 토큰의 잔액을 확인하세요.	`check token balance for 0xa2e57a3A7744eA20B5E2848817e9D66C6cb9f765 on contract 0x1234...5678`
거래 세부 정보 가져오기	해시를 통해 거래에 대한 자세한 정보를 검색합니다.	`get details for transaction 0xabcdef1234567890...`
가스 가격 알아보기	Monad 테스트넷의 현재 가스 가격을 알아보세요.	`what is the current gas price`
최신 블록 가져오기	Monad 테스트넷의 최신 블록에 대한 정보를 가져옵니다.	`show latest block info`
여러 잔액 가져오기	한 주소에 대한 여러 토큰의 잔액을 확인합니다.	`check multiple balances for 0xa2e57a3A7744eA20B5E2848817e9D66C6cb9f765 on contracts 0x1234...5678, 0x5678...1234`
센드몬	Monad 테스트넷의 지정된 주소로 MON 토큰을 보냅니다.	`send 0.1 MON to 0xb3f57a3A7744eA20B5E2848817e9D66C6cb9f765`
보내기 토큰	토큰 계약에서 지정된 주소로 ERC-20 토큰을 보냅니다.	`send 100 USDT to 0xb3f57a3A7744eA20B5E2848817e9D66C6cb9f765 from contract 0x1234...5678`
플레이 코인플립	앞면 또는 뒷면에 MON을 베팅하여 코인던지기 게임을 플레이하세요(최소 베팅 금액: 0.01 MON).	`flip 0.1 mon head`
동전 던지기 역사 얻기	승리, 손실, 이익을 포함한 주소에 대한 코인플립 게임의 기록을 확인하세요.	`history flip` 또는 `history flip 0xa2e57a3A7744eA20B5E2848817e9D66C6cb9f765`
스테이크-에프롬몬	Apriori 스테이킹 플랫폼에서 MON 토큰을 스테이킹하세요.	`stake 0.1 mon` 하면 MON 토큰을 스테이킹할 수 있습니다.
언스테이크-에프몬	Apriori 플랫폼에서 모든 MON 토큰을 언스테이킹하세요.	`unstake aprmon` 사용하여 스테이킹된 모든 MON 토큰을 스테이킹 해제하세요. 나중에 클레임에 사용할 요청 ID를 적어 두세요.
클레임-에프몬	보류 중인 스테이킹되지 않은 MON 토큰을 청구하세요.	스테이킹 해제 후 10분이 지나면 `claim aprmon requestID` 사용하세요. `requestID` 스테이킹 해제 과정에서 얻은 ID로 바꾸세요.
교환	Monad Testnet 네트워크를 위한 통합 Uniswap V2 스왑 기능	상장된 토큰의 경우: `swap 0.1 MON to USDT` . 상장되지 않은 토큰의 경우: `swap 0.1 MON to 0xxxxxxxxxxx` (컨트랙트 주소 사용).

Related MCP server: MCP Etherscan Server

빠른 시작

저장소를 복제합니다

지엑스피1

.env.example을 .env로 복사하고 구성하세요.

cp .env.example .env

개인 키로 .env를 편집하세요

nano .env

빌드하고 실행

npm run build node build/index.js

필수 조건

Node.js(v16 이상)
npm 또는 yarn
Claude Desktop(MCP 클라이언트 통합용)
거래 및 가스 수수료를 위한 충분한 MON이 있는 Monad 테스트넷 지갑(play-coinflip, send-mon 및 send-token에 필요)
Monad 테스트넷 지갑 Uniswap V2 계약 주소( UNISWAP_ROUTER_ADDRESS , UNISWAP_FACTORY_ADDRESS ) 및 WMON 계약 주소 (WMON_ADDRESS) 에 대한 PRIVATE_KEY 로 구성된 .env 파일

구성 및 사용

MCP 서버 초기화

src/index.ts 파일에서 서버는 지원되는 기능 목록으로 초기화됩니다.

const server = new McpServer({ name: "monad-testnet", version: "0.0.1", capabilities: [ "get-mon-balance", "get-token-balance", "get-transaction-details", "get-gas-price", "get-latest-block", "get-multiple-balances", "send-mon", "send-token", "play-coinflip", "get-coinflip-history", "stake-aprmon", "unstake-aprmon", "claim-aprmon", "get-aprmon-balance", "get-aprmon-rate", "get-aprmon-requests", "swap" ] });

환경 설정

서버를 구성하려면 예제 환경 파일을 복사하여 편집하세요.

cp .env.example .env

텍스트 편집기(예: nano , vim 또는 VS Code )를 사용하여 .env 파일을 편집하여 다음을 포함합니다.

PRIVATE_KEY=0xyourprivatekeyhere UNISWAP_ROUTER_ADDRESS=0xfb8e1c3b833f9e67a71c859a132cf783b645e436 UNISWAP_FACTORY_ADDRESS=0x733e88f248b742db6c14c0b1713af5ad7fdd59d0 WMON_ADDRESS=0x760AfE86e5de5fa0Ee542fc7B7B713e1c5425701

0xyourprivatekeyhere Monad 테스트넷 지갑의 개인 키( 0x 로 시작하는 64자리 16진수 문자)로 바꾸세요.

.env 파일이 안전하고 버전 관리 시스템에 등록되지 않았는지 확인하세요. .gitignore 파일에 추가하세요.

echo .env >> .gitignore

서버 빌드 및 실행

프로젝트를 빌드하세요:

npm run build

MCP 서버를 실행합니다.

node build/index.js

Claude Desktop과 통합

클로드 데스크톱을 엽니다.
Settings > Developer 로 이동하세요.
claude_desktop_config.json (일반적으로 ~/.config/Claude/ 또는 %APPDATA%\Claude\ 에 있음)을 편집하고 다음 구성을 추가합니다.

{ "mcpServers": { "monad-mcp": { "command": "node", "args": [ "/path/to/mcp-monad/build/index.js" ], "env": { "NODE_ENV": "production" } } } }

/path/to/mcp-monad/ 프로젝트 디렉토리의 실제 경로로 바꾸세요(예: Windows에서는 E:\proyek\mcp-monad , Linux에서는 /home/user/mcp-monad ).

Claude Desktop을 다시 시작합니다.
메시지가 표시되면 채팅 세션에 대한 MCP 액세스를 허용합니다( Allow for This Chat ).

기여하다

프로젝트 포크
Feature 브랜치를 생성합니다( git checkout -b feature/AmazingFeature )
변경 사항을 커밋하세요( git commit -m 'Add some AmazingFeature' )
브랜치에 푸시( git push origin feature/AmazingFeature )
풀 리퀘스트 열기

특허

MIT 라이선스에 따라 배포됩니다. 자세한 내용은 LICENSE 참조하세요.

연락하다

슬라메트 - @caridipesbuk

프로젝트 링크: https://github.com/Semutireng22/mcp-monad

노트

CoinflipGame 계약( 0x664e248c39cd70Fa333E9b2544beEd6A7a2De09b )에 play-coinflip 의 잠재적 상금을 충당할 수 있는 충분한 자금이 있는지 확인하세요. Monad 테스트넷 블록 탐색기를 사용하여 이를 확인할 수 있습니다.
다른 시스템을 사용하는 사용자의 경우 claude_desktop_config.json 에서 프로젝트 경로를 적절히 조정하세요.

문제 해결

서버가 시작되지 않습니다 . Claude Desktop( Settings > Developer ) 또는 터미널에서 "파일 .env 가 없습니다"와 같은 오류가 있는지 로그를 확인하세요. .env 유효한 PRIVATE_KEY 사용하여 프로젝트 루트에 있는지 확인하세요.
계약 잔액 부족 : 블록 탐색기를 사용하여 CoinflipGame 계약 잔액을 확인하세요. 계약 소유자는 fundGamePool 함수를 통해 잔액을 충전할 수 있습니다.
Claude 명령이 작동하지 않습니다 . claude_desktop_config.json 의 프로젝트 경로가 올바른지 확인하고 Claude Desktop을 다시 시작하세요.
TypeScript 오류 : npx tsc 실행하여 오류를 확인하세요. 다음을 사용하여 종속성을 업데이트하세요.

npm install

디버깅을 위해 MCP Inspector를 사용하세요 .

git clone https://github.com/modelcontextprotocol/inspector cd inspector npm install npm start

Monad MCP Server