Cyberlink MCP Server

Cyberlink MCP 서버

코스모스 기반 블록체인에서 CW-Social 스마트 계약과 상호작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 블록체인 내 엔티티 간의 의미적 관계인 사이버링크를 생성, 업데이트 및 쿼리하기 위한 표준화된 인터페이스를 제공합니다.

특징

• 핵심 운영
  • 사이버링크 생성, 읽기, 업데이트 및 삭제
  • 사용자 정의 식별자를 사용한 명명된 사이버 링크 지원
  • 효율적인 처리를 위한 일괄 작업
  • 필터링 및 페이지 매김 기능이 있는 풍부한 쿼리 기능
• 거래 관리
  • 실시간 거래 모니터링 및 상태 폴링
  • 자세한 거래 결과 및 오류 처리
  • 내부 및 외부 거래 서명 지원
  • 토큰 전송 기능
• 고급 기능
  • Hugging Face 변환기를 통한 의미적 임베딩 생성
  • 모델 작업에 대한 실시간 진행 상황 추적
  • 의미적 일치를 위한 코사인 유사도 계산
  • 포맷된 ID(fid)와 글로벌 ID(gid)를 갖춘 유연한 ID 시스템
  • UTC 지원을 통한 시간 범위 기반 쿼리
  • 소유자 기반 필터링 및 통계

필수 조건

• Node.js 16 이상
• npm 또는 yarn 패키지 관리자
• 실행 중인 Cosmos 블록체인 노드에 대한 액세스
• 거래에 필요한 충분한 자금이 있는 지갑
• 개발을 위한 커서 IDE
• AI 지원을 위한 Claude Desktop

설치

1. 저장소를 복제합니다.

지엑스피1

2. 종속성 설치:

3. 프로젝트를 빌드하세요:

4. 환경 변수 구성(구성 섹션 참조)

구성

MCP 서버 설정

~/.cursor/mcp.json 에 구성 파일을 만들거나 수정합니다.

필수 구성

필수 환경 변수:

• PATH_TO_YOUR_PROJECT : 프로젝트 디렉토리의 절대 경로
• NODE_URL : 코스모스 블록체인 노드 URL
• CONTRACT_ADDRESS : 배포된 스마트 계약 주소

선택적 구성

선택적 환경 변수:

• WALLET_MNEMONIC : 서명을 위한 지갑 니모닉(기본값: 없음 - 거래가 서명되지 않음)
• DENOM : 토큰 단위(기본값: "스테이크")
• BENCH32_PREFIX : BECH32 접두사

사용 가능한 도구

사이버링크 관리

생성 도구

사이버링크 생성

• 설명: 단일 사이버링크 생성
• 필수: type
• 선택 사항: from , to , value

사이버링크2 만들기

• 설명: 노드 + 링크 생성
• 필수: node_type , link_type
• 선택 사항: node_value , link_value , link_to_existing_id , link_from_existing_id

이름이 지정된 사이버링크 만들기

• 설명: 명명된 사이버링크 생성(관리자 전용)
• 필수: name , cyberlink

사이버링크 생성

• 설명: 사이버링크 일괄 생성
• 필수: cyberlinks[]

수정 도구

사이버링크 업데이트

• 설명: 기존 사이버링크 업데이트
• 필수: gid , cyberlink

사이버링크 삭제

• 설명: 사이버링크 제거
• 필수: gid

임베딩을 통한 업데이트

• 설명: 의미적 임베딩 추가
• 필수: formatted_id

쿼리 작업

기본 쿼리

쿼리_바이_gid

• 설명: 글로벌 ID로 가져오기
• 필수: gid

FID별 쿼리

• 설명: 포맷된 ID로 가져오기
• 필수: fid

쿼리_사이버링크

• 설명: 페이지 번호가 있는 모든 항목 나열
• 매개변수: limit , start_after

쿼리_네임드_사이버링크

• 설명: 이름이 지정된 사이버링크 목록
• 매개변수: limit , start_after

쿼리_바이_GID

• 설명: ID로 여러 개 가져오기
• 필수: gids[]

필터링된 쿼리

유형별 사이버링크 쿼리

• 설명: 유형별 필터링
• 필수: type

쿼리_사이버_링크_by_from

• 설명: 소스별 필터링
• 필수: from

쿼리_사이버_링크_by_to

• 설명: 대상별 필터링
• 필수: to

소유자 및 유형별 사이버 링크 쿼리

• 설명: 소유자 및 유형별 필터링
• 필수: owner , type

시간 기반 쿼리

소유자 시간별 사이버 링크 쿼리

• 설명: 생성 시간별 필터링
• 필수: owner , start_time

소유자별_사이버_링크_쿼리_시간_아무렇지 않게

• 설명: 언제든지 필터링
• 필수: owner , start_time

시스템 운영

계약 정보

쿼리_마지막_ID

• 설명: 마지막으로 할당된 ID 가져오기

쿼리_구성

• 설명: 계약 구성 가져오기

쿼리_디버그_상태

• 설명: 디버그 상태 가져오기(관리자 전용)

get_graph_stats

• 설명: 그래프 통계 가져오기

거래 및 지갑

쿼리_트랜잭션

• 설명: 거래 상태 가져오기
• 필수: transaction_hash

get_tx_status

• 설명: 자세한 거래 상태 가져오기
• 필수: transaction_hash

지갑 잔액 조회

• 설명: 지갑 잔액 가져오기

보내기_토큰

• 설명: 토큰 전송
• 필수: recipient , amount

쿼리 매개변수

시간 범위 형식

• 모든 타임스탬프는 ISO 8601 형식이어야 합니다.
• 예: 2024-06-01T12:00:00Z
• 지정하지 않으면 UTC 시간대가 가정됩니다.
• start_time 은 필수이고 end_time 선택 사항입니다.

쪽수 매기기

• start_after : 페이지 매김 커서
• limit : 페이지당 결과 수(기본값: 50)

개발

빌드 명령

프로젝트 구조

오류 코드

잘못된 매개변수

• 설명: 잘못된 매개변수
• 일반적인 원인: 필수 필드 누락, 잘못된 형식

메서드를 찾을 수 없음

• 설명: 알 수 없는 도구
• 일반적인 원인: 도구 이름의 오타, 더 이상 사용되지 않는 도구

내부 오류

• 설명: 시스템 오류
• 일반적인 원인: 네트워크 문제, 계약 오류

SSE를 통해 MCP 실행

Docker를 사용하여 MCP 서버를 실행하여 SSE 서버로 전환할 수 있습니다. 이렇게 하면 Hugging Face 모델 캐시가 실행 간에 유지되고 .env 파일에서 환경 변수가 로드됩니다.

• -v $(pwd)/hf-cache:/app/hf-cache 모델 캐싱을 위한 로컬 디렉토리를 마운트하므로 모델이 매번 다시 다운로드되지 않습니다.
• --env-file .env``.env 파일에서 환경 변수를 로드합니다.
• -p 8000:8000 포트 8000의 서버를 노출합니다.
• --name cw-social 은 컨테이너의 이름을 지정하여 관리를 용이하게 합니다.

기여하다

1. 저장소를 포크하세요
2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
3. 변경 사항을 커밋하세요( git commit -m 'Add amazing feature' )
4. 브랜치에 푸시( git push origin feature/amazing-feature )
5. 풀 리퀘스트 열기

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.