Hedera MCP Server

헤데라 MCP 서버

헤데라 네트워크와 상호 작용하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 헤데라 지갑 생성, 계좌 잔액 확인, 거래 생성 및 서명된 거래 전송을 위한 도구를 제공합니다.

⚠️ 보안 경고

이는 데모 구현이므로 실제 운영 환경에서는 사용해서는 안 됩니다. 현재 구현에는 다음과 같은 여러 보안 취약점이 있습니다.

• 개인 키는 응답 본문에 전송됩니다.
• 민감한 데이터 암호화 없음
• 거래 검증 메커니즘이 없습니다

이 구현은 MCP 개념을 보여주기 위한 것이며, 프로덕션 환경에서 사용하기 전에 적절하게 보안이 유지되어야 합니다.

주요 목표

이 MCP 서버의 주요 목적은 클라이언트가 트랜잭션 검증만 하면 MCP 서버에서 트랜잭션 생성 및 실행을 처리하는 방식을 보여주는 것입니다. 구체적으로는 다음과 같습니다.

1. 거래 구성은 전적으로 MCP 서버에서 이루어집니다.
2. 클라이언트는 구성된 거래에 서명합니다.
3. MCP 서버는 Hedera 네트워크에 대한 거래 제출을 처리합니다.
4. 이 아키텍처는 중앙화된 거래 논리를 허용하고 클라이언트 측 복잡성을 줄입니다.

필수 조건

• Node.js(v18 이상)
• npm 또는 yarn
• Hedera 계정(테스트넷 또는 메인넷용)

설치

1. 이 저장소를 복제하세요:지엑스피1
2. 종속성 설치:
   npm install
3. Hedera 자격 증명을 사용하여 루트 디렉토리에 .env 파일을 만듭니다.
   HEDERA_OPERATOR_ID=your-operator-account-id HEDERA_OPERATOR_KEY=your-operator-private-key HEDERA_NETWORK=testnet # or mainnet PORT=3000 # optional, defaults to 3000

애플리케이션 구축

TypeScript 코드를 컴파일합니다.

자동 재컴파일을 통한 개발의 경우:

서버 실행

서버를 시작합니다:

서버는 http://localhost:3000 (또는 .env 파일에 지정된 포트)에서 사용할 수 있습니다.

테스트 클라이언트로 테스트하기

저장소에는 MCP 서버에 연결하고 해당 도구를 사용하는 방법을 보여주는 테스트 클라이언트 스크립트가 포함되어 있습니다. 이 클라이언트는 사용 가능한 모든 도구를 보여주는 완전한 엔드 투 엔드 흐름을 제공합니다.

테스트 클라이언트를 실행합니다.

테스트 클라이언트는 다음을 수행합니다.

1. MCP 서버에 연결
2. 사용 가능한 도구 나열
3. 새로운 Hedera 지갑을 만드세요(create-wallet 도구)
4. 신규 계좌 잔액 확인 (잔액 확인 도구)
5. 계정의 전체 잔액을 운영자 계정으로 이체하는 거래를 구축합니다(거래 구축 도구)
6. Hedera SDK를 사용하여 클라이언트 측에서 거래에 서명합니다.
7. 서명된 거래를 Hedera 네트워크에 제출합니다(거래 전송 도구)
8. 거래 결과를 표시합니다

이는 계정 생성부터 거래 제출까지 MCP 서버를 통해 Hedera 네트워크와 상호 작용하는 전체 수명 주기를 보여줍니다.

사용 가능한 MCP 도구

서버는 다음과 같은 도구를 제공합니다.

1. create-wallet : 최소 초기 잔액으로 새로운 Hedera 계정을 생성합니다.
   • 입력 매개변수가 필요하지 않습니다
   • 계정 ID, 공개 키, 개인 키를 반환합니다.
2. check-balance : Hedera 계좌의 잔액을 확인합니다.
   • 입력: accountId (문자열)
   • 계좌 잔액을 tinybars로 반환합니다.
3. build-transaction : 서명 없이 이체 거래를 빌드합니다.
   • 입력:
     • senderAccountId (문자열)
     • recipientAccountId (문자열)
     • amount (숫자, 작은 막대)
   • Base64로 인코딩된 트랜잭션을 반환합니다.
4. send-transaction : 서명된 트랜잭션을 Hedera 네트워크로 보냅니다.
   • 입력: signedTransaction (문자열, base64로 인코딩됨)
   • 거래 상태 및 ID를 반환합니다.

전개

간단한 배포 스크립트가 포함되어 있습니다.

먼저 실행 가능하게 만들어야 합니다.