하이브 MCP 서버

모델 컨텍스트 프로토콜을 통해 AI 어시스턴트가 Hive 블록체인과 상호 작용할 수 있도록 하는 MCP 서버입니다.

개요

이 서버는 Claude와 같은 AI 보조원과 Hive 블록체인을 연결하는 브리지 역할을 하며, 이를 통해 AI 모델은 다음과 같은 작업을 수행할 수 있습니다.

• 계정 정보 및 내역 가져오기
• 블로그 게시물 및 토론 검색
• 태그 또는 사용자별로 게시물 가져오기
• 콘텐츠에 투표하고 게시물을 작성하세요(적절하게 인증된 경우)
• HIVE 또는 HBD 토큰을 다른 계정으로 보내기
• Hive 키로 메시지 서명 및 확인
• 암호화된 메시지 보내기 및 받기

특징

프롬프트

• create-post - AI가 올바른 형식과 태그를 사용하여 새로운 Hive 게시물을 만들도록 안내하는 구조화된 프롬프트를 생성합니다.
• analyze-account - Hive 계정의 통계, 게시 기록 및 활동 패턴을 분석하라는 메시지를 생성합니다.

도구

데이터 읽기

• get_account_info - Hive 블록체인 계정에 대한 자세한 정보를 가져옵니다.
• get_post_content - 작성자 및 퍼머링크로 특정 게시물 검색
• get_posts_by_tag - 태그 및 카테고리(트렌드, 인기 등)로 게시물을 검색합니다.
• get_posts_by_user - 특정 사용자 또는 해당 피드에서 게시물 가져오기
• get_account_history - 선택적 작업 필터링을 사용하여 계정의 거래 내역을 가져옵니다.
• get_chain_properties - 현재 Hive 블록체인 속성 및 통계 가져오기
• get_vesting_delegations - 특정 계정에서 이루어진 위임 위임 목록을 가져옵니다.

블록체인 상호작용(인증 필요)

• vote_on_post - Hive 콘텐츠에 대한 투표(게시 키 필요)
• create_post - Hive 블록체인에 새로운 블로그 게시물을 만듭니다(게시 키 필요)
• create_comment - 기존 게시물에 댓글을 달거나 댓글에 답변합니다(게시 키 필요)
• send_token - HIVE 또는 HBD 암호화폐를 다른 계정으로 보내기(활성 키 필요)

암호화

• sign_message - Hive 개인 키를 사용하여 메시지에 서명합니다.
• verify_signature - Hive 공개 키에 대해 메시지 서명을 확인합니다.

암호화된 메시징

• encrypt_message - 특정 Hive 계정에 대한 메시지 암호화
• decrypt_message - 특정 Hive 계정에서 암호화된 메시지를 해독합니다.
• send_encrypted_message - 토큰 전송을 사용하여 암호화된 메시지를 보냅니다.
• get_encrypted_messages - 계정 기록에서 메시지를 검색하고 선택적으로 해독합니다.

MCP Inspector를 사용한 디버깅

MCP Inspector는 서버를 테스트하고 디버깅하기 위한 대화형 인터페이스를 제공합니다.

지엑스피1

인증 구성

인증된 작업(투표, 게시, 토큰 전송)을 활성화하려면 환경 변수를 설정해야 합니다.

보안 참고 : 개인 키를 공유하거나 버전 관리 시스템에 커밋하지 마세요. 환경 변수나 안전한 구성 방식을 사용하세요.

AI 어시스턴트와의 통합

클로드 데스크탑

Claude Desktop과 함께 이 서버를 사용하려면:

1. Claude Desktop이 설치되어 있는지 확인하세요.
2. Claude 구성 파일을 열거나 만듭니다.
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • 리눅스: ~/.config/Claude/claude_desktop_config.json
3. 구성에 이 서버를 추가하세요:

윈드서핑과 커서

동일한 JSON 구성이 Windsurf( windsurf_config.json ) 및 Cursor(버전 >= 0.47의 경우 ~/.cursor/mcp.json )에 적용됩니다.

이전 버전에서는 설정의 MCP 섹션에서 1줄 명령 형식을 사용해야 했습니다. env HIVE_USERNAME=your-hive-username env HIVE_POSTING_KEY=your-hive-posting-private-key env HIVE_ACTIVE_KEY=your-hive-active-private-key env HIVE_MEMO_KEY=your-hive-memo-private-key npx -y @gluneau/hive-mcp-server

예시

MCP 클라이언트에 연결되면 다음과 같은 질문을 할 수 있습니다.

• "Hive에서 #photography 태그로 가장 인기 있는 게시물은 무엇인가요?"
• "사용자 이름 'alice'의 최근 게시물을 보여주세요"
• "밥의 계좌 잔액과 세부 정보는 어떻게 되나요?"
• "'찰리'의 거래 내역을 받아보세요"
• "'dave'의 게시물에 퍼머링크 'my-awesome-post'를 붙여 추천해 주실 수 있나요?"
• "Hive에 AI 기술에 대한 새 게시물을 작성하세요"
• "사용자 'frank'에게 '도움을 주셔서 감사합니다!'라는 메모와 함께 HIVE 1개를 보내세요."
• "내 Hive 게시 키로 이 메시지에 서명하세요: '내 신원 확인'"
• "현재 Hive 블록체인의 특징은 무엇입니까?"
• "사용자 'grace'가 한 위임을 보여주세요"
• "사용자 'alice'에게 이 메시지를 암호화합니다: '이것은 비밀 메시지입니다'"
• "'밥'이 보낸 이 메시지를 해독하세요: '#4f3a5b...'"
• "'찰리'에게 '내일 만나자'는 내용의 암호화된 메시지를 보내세요."
• "암호화된 메시지를 보여주시고 해독해 주세요"
• "내가 '데이브'와 주고받은 마지막 암호화된 메시지 10개를 가져와"

도구 문서

get_account_info

잔액, 권한, 투표권 및 기타 지표를 포함한 Hive 블록체인 계정에 대한 자세한 정보를 가져옵니다.

• 매개변수:
  • username : 정보를 가져올 Hive 사용자 이름

get_post_content

작성자와 퍼머링크로 식별된 특정 Hive 블로그 게시물을 검색합니다.

• 매개변수:
  • author : 게시물 작성자
  • permlink : 게시물의 Permlink

get_posts_by_tag

특정 태그로 필터링하고 카테고리별로 정렬한 Hive 게시물을 검색합니다.

• 매개변수:
  • category : 정렬 카테고리(트렌드, 인기, 생성 등)
  • tag : 게시물을 필터링할 태그
  • limit : 반환할 게시물 수(1-20)

get_posts_by_user

특정 Hive 사용자가 작성하거나 피드에 있는 게시물을 검색합니다.

• 매개변수:
  • category : 가져올 사용자 게시물 유형(블로그 또는 피드)
  • username : 게시물을 가져올 Hive 사용자 이름
  • limit : 반환할 게시물 수(1-20)

get_account_history

선택적 작업 유형 필터링을 사용하여 Hive 계정의 거래 내역을 검색합니다.

• 매개변수:
  • username : 하이브 사용자 이름
  • limit : 반환할 작업 수
  • operation_filter : 필터링할 작업 유형의 선택적 목록

get_chain_properties

현재 Hive 블록체인 속성과 통계를 가져옵니다.

• 매개변수: 없음

get_vesting_delegations

특정 Hive 계정에서 이루어진 위임된 권한 목록을 가져옵니다.

• 매개변수:
  • username : 위임을 받을 Hive 계정
  • limit : 검색할 최대 위임 수
  • from : 페이지 매김을 위한 선택적인 시작 계정

vote_on_post

구성된 Hive 계정을 사용하여 Hive 게시물에 투표하세요(추천 또는 비추천).

• 매개변수:
  • author : 투표할 게시물의 작성자
  • permlink : 투표할 게시물의 Permlink
  • weight : 투표 가중치 -10000(100% 다운보트)에서 10000(100% 업보트)까지

create_post

구성된 계정을 사용하여 Hive 블록체인에 새로운 블로그 게시물을 만듭니다.

• 매개변수:
  • title : 블로그 게시물의 제목
  • body : 블로그 게시물의 내용(마크다운 지원)
  • tags : 게시물에 대한 태그
  • 보상, 수혜자 등에 대한 다양한 선택 매개변수

create_comment

기존 Hive 게시물에 댓글을 작성하거나 다른 댓글에 답변합니다.

• 매개변수:
  • parent_author : 답글을 달고 있는 게시물 작성자 또는 댓글의 사용자 이름
  • parent_permlink : 답글을 달고 있는 게시물이나 댓글의 영구 링크
  • body : 댓글 내용 (마크다운 지원)
  • 보상, 수혜자 등에 대한 다양한 선택 매개변수

send_token

구성된 계정을 사용하여 HIVE 또는 HBD 토큰을 다른 Hive 계정으로 보냅니다.

• 매개변수:
  • to : 수신자 Hive 사용자 이름
  • amount : 보낼 토큰의 양
  • currency : 보낼 통화(HIVE 또는 HBD)
  • memo : 거래에 포함할 선택적 메모

sign_message

환경 변수의 Hive 개인 키를 사용하여 메시지에 서명합니다.

• 매개변수:
  • message : 서명할 메시지
  • key_type : 사용할 키 유형(게시, 활성 또는 메모)

verify_signature

Hive 공개 키에 대한 디지털 서명을 확인합니다.

• 매개변수:
  • message_hash : 16진수 형식의 메시지의 SHA-256 해시
  • signature : 검증할 서명 문자열
  • public_key : 검증할 공개 키

encrypt_message

메모 암호화를 사용하여 특정 Hive 계정에 대한 메시지를 암호화합니다.

• 매개변수:
  • message : 암호화할 메시지
  • recipient : 수신자의 Hive 사용자 이름

decrypt_message

특정 Hive 계정에서 받은 암호화된 메시지를 해독합니다.

• 매개변수:
  • encrypted_message : 암호화된 메시지(#으로 시작)
  • sender : 발신자의 Hive 사용자 이름

send_encrypted_message

소액 토큰 전송을 사용하여 Hive 계정으로 암호화된 메시지를 보냅니다.

• 매개변수:
  • message : 암호화하여 보낼 메시지
  • recipient : 수신자의 Hive 사용자 이름
  • amount : 보낼 HIVE의 양(최소 0.001, 기본값: 0.001)

get_encrypted_messages

선택적으로 복호화하여 계정 기록에서 암호화된 메시지를 검색합니다.

• 매개변수:
  • username : 암호화된 메시지를 가져올 Hive 사용자 이름
  • limit : 검색할 최대 메시지 수(기본값: 20)
  • decrypt : 메시지의 암호 해독을 시도할지 여부(기본값: false)

개발

프로젝트 구조

• src/index.ts - 메인 서버 구현
• src/tools/ - 모든 도구 구현
• src/schemas/ - 도구 매개변수에 대한 Zod 스키마
• src/utils/ - Hive 블록체인과 상호 작용하기 위한 유틸리티 함수
• src/config/ - 클라이언트 구성 및 로그 수준 처리

종속성

• @hiveio/dhive - Hive 블록체인 클라이언트
• @modelcontextprotocol/sdk - MCP SDK
• zod - 스키마 검증

특허

아이에스씨

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

더 자세한 기여 지침은 CONTRIBUTING.md 파일을 참조하세요.