모나드 MCP 서버

이 프로젝트는 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` (컨트랙트 주소 사용).

빠른 시작

저장소를 복제합니다

지엑스피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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

잔액 확인, 거래 세부 정보 조사, 가스 가격 확인, 블록 정보 검색 등을 위해 Monad 테스트넷과 상호 작용할 수 있습니다.

Related MCP Servers

Flow MCP
Outblock
A
security
A
license
A
quality
Provides tools for interacting with the Flow blockchain, including Flow balance checking, token balance querying, and Cadence Owned Account information retrieval.
Last updated -
5
74
1
TypeScript
MIT License
hackle-mcpofficial
hackle-io
A
security
A
license
A
quality
A Model Context Protocol server for Hackle API providing tools and resources for querying A/B Test data.
Last updated -
76
1
JavaScript
MIT License
MCP Smart Contract Analyst
RockYuan
-
security
-
license
-
quality
Enables interaction with the Monad blockchain to analyze smart contract source code for functionality and security, with decompilation support for unverified contracts.
Last updated -
TypeScript
Apache 2.0
Monad NFT Analytics MCP
Sifu213
-
security
-
license
-
quality
A server that retrieves NFT-related data on the Monad testnet, allowing users to check NFT holders, calculate portfolio values, view collections, and track top-selling NFTs by volume and sales across different time periods.
Last updated -
TypeScript

View all related MCP servers

Monad MCP Server