모나드 MCP 서버

이 MCP(Model Context Protocol) 서버는 Monad 테스트넷과 상호 작용하도록 설계되었습니다. MON 토큰 잔액 확인, 트랜잭션 전송, 스마트 컨트랙트 배포, 블록체인 이벤트 모니터링 등 개발자가 Monad 블록체인에 참여할 수 있는 다양한 도구와 기능을 제공합니다.

MCP란 무엇인가요?

모델 컨텍스트 프로토콜(MCP)은 AI 모델이 외부 도구, 서비스 및 데이터 소스와 안전하고 효과적으로 상호 작용할 수 있도록 하는 표준화된 인터페이스입니다. 이 서버는 MCP를 구현하여 호환되는 AI 에이전트 또는 애플리케이션에 모나드 블록체인 기능을 제공합니다.

Related MCP server: Solana MCP Server

프로젝트 구조

이 프로젝트는 다음과 같이 구성됩니다.

지엑스피1

주요 구성 요소

• src/index.ts : 서버의 주요 진입점입니다. MCP 서버 인스턴스를 초기화하고 사용 가능한 모든 도구(지갑, 컨트랙트, NFT, 블록)를 등록합니다.

• src/config/server.ts : 이 파일은 핵심 서버 구성을 처리합니다. McpServer 인스턴스를 이름, 버전 및 기능 목록으로 설정합니다. 또한 Monad 테스트넷과 상호 작용하기 위한 Viem 공개 클라이언트를 초기화하고, 환경 변수의 개인 키를 사용하여 Viem 지갑 클라이언트를 생성하는 함수를 제공합니다. 서버는 통신을 위해 StdioServerTransport 사용합니다.

• src/tools/ : 이 디렉터리에는 다양한 MCP 도구의 구현이 포함되어 있습니다. 각 하위 디렉터리는 일반적으로 모나드 상호 작용의 특정 측면에 중점을 둡니다.

  • walletProvider : MON 토큰 잔액과 거래를 관리합니다.

  • contractProvider : 스마트 계약 배포 및 이벤트 감시를 처리합니다.

  • nftProvider : Monad 네트워크에서 NFT를 쿼리하는 기능을 제공합니다.

  • blockProvider : 블록 정보를 검색하는 도구를 제공합니다.

필수 조건

시작하기 전에 다음 사항이 설치되어 있는지 확인하세요.

• Node.js(버전 16 이상)

• Node.js 패키지 관리자: npm , yarn 또는 pnpm (이 프로젝트에서는 예시에서 pnpm 사용함)

• Claude Desktop(또는 MCP 호환 클라이언트)을 사용하여 서버와 상호 작용합니다.

환경 변수(.env)

이 프로젝트에서는 환경 변수를 사용하여 민감한 정보, 주로 Monad 계정의 개인 키를 관리합니다.

1. 예제 파일을 복사합니다 . .env.example 의 사본을 만들고 이름을 .env 로 바꿉니다.

   cp .env.example .env

2. .env 편집 : 텍스트 편집기에서 새로 만든 .env 파일을 엽니다.

3. PRIVATE_KEY 설정 : PRIVATE_KEY 변수에 Monad 계정의 개인 키를 입력합니다. 이 키는 트랜잭션 전송이나 컨트랙트 배포와 같은 작업에 필요합니다.

   PRIVATE_KEY="0xyourprivatekeyhere"

   중요 : 개인 키가 0x 로 시작하는지 확인하세요.

4. 보안 : .env 파일을 Git 저장소에 커밋하지 마세요. .gitignore 파일에는 이를 방지하도록 이미 설정되어 있지만, 개인 키 보호에 항상 유의하세요.

시작하기

Monad MCP 서버를 설정하고 실행하려면 다음 단계를 따르세요.

1. 저장소 복제 :

   아직 하지 않았다면 GitHub에서 프로젝트를 복제하세요.

   git clone https://github.com/lispking/monad-mcp-server.git
   cd monad-mcp-server

2. 종속성 설치 :

   pnpm (또는 선호하는 패키지 관리자)을 사용하여 package.json 에 나열된 프로젝트 종속성을 설치합니다.

   pnpm install

3. 프로젝트 빌드 :

   서버는 TypeScript로 작성되었으며 JavaScript로 컴파일해야 합니다. 빌드 스크립트를 실행하세요.

   pnpm build

   이 명령은 package.json 에 정의된 tsc (TypeScript 컴파일러)를 사용하여 src 디렉토리의 소스 파일을 build 디렉토리로 컴파일합니다.

이제 서버가 구축되어 MCP 클라이언트에서 사용할 준비가 되었습니다.

서버 기능

src/config/server.ts 에 정의된 대로 서버는 다음과 같은 기능을 제공합니다.

• get-mon-balance : 계정의 MON 토큰 잔액을 검색합니다.

• send-mon-transaction : 한 계정에서 다른 계정으로 MON 토큰을 보냅니다.

• deploy-mon-contract : Monad 테스트넷에 스마트 계약을 배포합니다.

• watch-contract-events : 특정 스마트 계약에서 발생하는 이벤트를 모니터링하고 보고합니다.

• query-mon-nft : Monad 네트워크의 NFT(Non-Fungible Token)에 대한 정보를 쿼리합니다.

• get-latest-block : Monad 테스트넷에서 가장 최근 블록의 세부 정보를 가져옵니다.

• get-block-by-number : 블록 번호로 특정 블록을 검색합니다.

클라이언트에 MCP 서버 구성 추가

이 서버를 MCP 호환 클라이언트(예: Claude Desktop)와 함께 사용하려면 클라이언트 설정에 해당 구성을 추가해야 합니다. 정확한 방법은 클라이언트에 따라 다를 수 있지만, 일반적으로 서버 실행 방식을 지정하는 것이 포함됩니다.

다음은 구성 스니펫의 예입니다.

{
  "mcpServers": {
    // ... other server configurations ...
    "monad-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/your/project/monad-mcp-server/build/index.js"
      ],
      "env": {
        "PRIVATE_KEY": "<your_monad_private_key_if_not_using_dotenv_or_to_override>"
      }
    }
    // ... other server configurations ...
  }
}

구성 필드에 대한 설명 :

• "monad-mcp" : 클라이언트 내에서 이 서버 구성에 지정하는 고유한 이름입니다.

• "command": "node" : 서버가 Node.js 애플리케이션임을 지정합니다.

• "args" : node 명령에 전달할 인수 배열입니다.

  • 첫 번째 인수는 서버의 컴파일된 진입점 경로입니다( /absolute/path/to/your/project/monad-mcp-server/build/index.js ). /absolute/path/to/your/project/``monad-mcp-server 저장소를 복제한 실제 절대 경로로 바꾸세요.

• "env" : 서버 프로세스에 대한 환경 변수를 설정하는 객체입니다.

  • "PRIVATE_KEY" : 개인 키를 여기에 설정할 수 있습니다. 하지만 일반적으로 보안 강화를 위해 .env 파일을 사용하는 것이 좋습니다. 여기에 설정하면 클라이언트 동작 및 서버의 환경 변수 로딩 순서에 따라 .env 의 값이 재정의될 수 있습니다.

참고 : "args" 의 경로가 올바르고 프로젝트 디렉토리 내의 build/index.js 파일을 가리키는지 확인하세요.

추가 자료

사용된 기술과 관련 개념에 대한 자세한 내용은 다음 공식 문서를 참조하세요.

• 모델 컨텍스트 프로토콜(MCP) 문서

• 모나드 문서

• Viem 문서 (Viem은 이 프로젝트에서 사용되는 Ethereum/Monad 클라이언트 라이브러리입니다)

이 포괄적인 README는 Monad MCP 서버, 설정 및 사용법에 대한 확실한 이해를 제공합니다.