random-web3-mcp

RandomWeb3MCP - Web3 랜덤 요소 생성 서비스

RandomWeb3MCP는 EVM 블록 해시 기반 난수 생성 서비스입니다. 이 서비스는 게임, 금융, 테스트 및 기타 분야에서 사용할 수 있는 다양한 난수 생성 도구를 제공합니다.

특징

• 검증 가능성 : 모든 난수는 블록체인 해시를 기반으로 생성되므로 공정성과 검증 가능성이 보장됩니다.
• 다양성 : 기본 난수부터 복잡한 확률 분포까지 다양한 난수 생성 시나리오를 지원합니다.
• 신뢰성 : 무작위성 품질을 보장하기 위해 엔트로피 소스로 블록체인을 사용합니다.
• 사용성 : 간편한 통합을 위한 간단하고 직관적인 API 인터페이스 제공

설치

지엑스피1

빠른 시작

tico 또는 커서 구성

커서 설정에 random-web3-mcp 서비스 구성을 추가합니다.

도구 목록

기본_난수_생성

이름

기본 난수 생성기

기능

지정된 범위 내에서 난수 정수를 생성합니다.

매개변수

• min_value(정수, 선택 사항): 최소값(포함). 기본값은 0입니다.
• max_value(정수, 선택 사항): 최대값(포함). 기본값은 1000000입니다.
• salt (str, 선택 사항): 무작위성을 높이기 위한 난수 salt 값입니다. 기본값은 ''입니다.

보고

난수 결과를 포함하는 JSON 문자열

응용 프로그램 시나리오

1. 복권 시스템
2. 게임 난수
3. 랜덤 ID 생성
4. 테스트 데이터 생성

난수 배열 생성

이름

난수 배열 생성기

기능

지정된 길이의 무작위 배열을 생성합니다

매개변수

• array_length(정수, 선택 사항): 배열 길이입니다. 기본값은 1입니다.
• min_value(정수, 선택 사항): 최소값입니다. 기본값은 0입니다.
• max_value(정수, 선택 사항): 최대값입니다. 기본값은 1000000입니다.
• salt(str, 선택 사항): 무작위 숫자 salt 값. 기본값은 ''입니다.

보고

난수 배열을 포함하는 JSON 문자열

응용 프로그램 시나리오

1. 일괄 난수 생성
2. 무작위 표본 추출
3. 테스트 데이터 세트 생성
4. 무작위 작업 할당

무작위 가중치 생성

이름

가중 난수 선택기

기능

가중치에 따라 무작위로 옵션을 선택합니다.

매개변수

• 옵션(List[str]): 옵션 목록
• 가중치(List[int]): 해당 가중치 목록(0-1000)
• salt(str, 선택 사항): 무작위 숫자 salt 값. 기본값은 ''입니다.

보고

선택 결과를 포함하는 JSON 문자열

응용 프로그램 시나리오

1. 복권 시스템(다양한 확률의 상금)
2. 무작위 드롭(가중치 아이템 드롭)
3. 업무 할당(우선순위 기반)
4. A/B 테스트(비율이 다른 실험 그룹)

무작위 기능 생성

이름

랜덤 피처 할당기

기능

객체에 대한 무작위 특징 값 집합을 생성합니다. 각 특징 값은 지정된 범위 내에 있습니다. 특징 값은 비트맵으로 인코딩되며, 각 특징은 8비트를 차지합니다.

매개변수

• feature_count(int): 생성할 기능 수
• feature_max_values(List[int]): 각 기능에 대한 최대값 목록, 길이는 feature_count와 같아야 함
• salt (str, 선택 사항): 무작위성을 높이기 위한 난수 salt 값입니다. 기본값은 ''입니다.

보고

기능 값과 비트맵을 포함하는 JSON 문자열, 형식은 다음과 같습니다.

응용 프로그램 시나리오

1. 게임 캐릭터 속성 생성(힘, 민첩성, 지능 등)
2. 장비 속성 무작위화(공격력, 방어력, 속도 등)
3. 생물학적 특성 시뮬레이션(유전자, 특성 등)
4. 무작위 장면 생성(지형, 날씨, 환경 등)

생성_분포

이름

확률 분포 난수 생성기

기능

지정된 확률 분포 유형과 매개변수에 따라 난수를 생성합니다. 다양한 일반 확률 분포를 지원합니다.

매개변수

• distribution_type(int): 배포 유형:
  • 1 = 균일 분포(매개변수: [최소값, 최대값])
  • 2 = 정규 분포(매개변수: [평균, 표준편차])
  • 3 = 지수 분포(매개변수: [scale_parameter])
  • 4 = 이항 분포(매개변수: [시도 횟수, 성공 확률])
• distribution_parameters (List[float]): 분포 매개변수 목록
• salt (str, 선택 사항): 무작위성을 높이기 위한 난수 salt 값입니다. 기본값은 ''입니다.

보고

무작위 값과 분포 정보를 포함하는 JSON 문자열, 형식은 다음과 같습니다.

응용 프로그램 시나리오

1. 금융시장 시뮬레이션(수익률 분포, 위험 분석)
2. 자연 현상 시뮬레이션(입자 분포, 노이즈 생성)
3. 부하 테스트(사용자 행동 분포)
4. 통계적 샘플링(실험적 데이터 생성)

무작위 이벤트 생성

이름

무작위 이벤트 트리거

기능

주어진 확률에 따라 일련의 이벤트를 트리거합니다. 각 이벤트는 독립적인 트리거 확률을 갖습니다. 비트맵을 사용하여 트리거 상태를 기록하여 쉽게 처리할 수 있습니다.

매개변수

• event_count(int): 총 이벤트 수
• event_probabilities(List[int]): 각 이벤트에 대한 트리거 확률(0-1000, 0-100%를 나타냄)
• salt (str, 선택 사항): 무작위성을 높이기 위한 난수 salt 값입니다. 기본값은 ''입니다.

보고

이벤트 트리거 결과가 포함된 JSON 문자열(형식:

응용 프로그램 시나리오

1. 게임 무작위 이벤트(트리거 플롯, 아이템 드롭)
2. 확률 효과 판정 (스킬 발동, 콤보 판정)
3. 위험 이벤트 시뮬레이션(고장 예측, 사고 이벤트)
4. 다중 조건 결정(결합 확률 이벤트)

무작위 시드 생성

이름

난수 생성기

기능

암호화 또는 고품질 난수가 필요한 기타 시나리오를 위해 고엔트로피 난수 시드를 생성합니다. 블록체인 해시를 엔트로피 소스로 사용하여 난수성을 보장합니다.

매개변수

• seed_length(int): 생성할 시드의 길이(바이트)
• salt (str, 선택 사항): 무작위성을 높이기 위한 난수 salt 값입니다. 기본값은 ''입니다.

보고

난수 시드를 포함하는 JSON 문자열, 형식은 다음과 같습니다.

응용 프로그램 시나리오

1. 키 생성(암호화 키, 서명 시드)
2. 보안 토큰(세션 식별자, 인증 토큰)
3. 난수 초기화(PRNG 시드, 시뮬레이션 초기 상태)
4. 고유 식별자 생성(UUID 시드, 임의 식별자)

셔플_배열

이름

랜덤 배열 셔플러

기능

입력 배열을 무작위로 섞어 각 요소가 어떤 위치에든 나타날 확률이 동일하도록 합니다. 공정성을 보장하기 위해 Fisher-Yates 셔플 알고리즘을 사용합니다.

매개변수

• input_array(리스트): 섞을 배열, 요소는 어떤 유형이든 가능
• salt (str, 선택 사항): 무작위성을 높이기 위한 난수 salt 값입니다. 기본값은 ''입니다.

보고

셔플된 배열을 포함하는 JSON 문자열, 형식은 다음과 같습니다.

응용 프로그램 시나리오

1. 게임 셔플링(플레잉 카드, 마작 패)
2. 무작위 순서(질문 순서, 재생 목록)
3. 무작위 그룹화(팀 배정, 실험 그룹화)
4. 데이터 셔플링(훈련 데이터 세트, 테스트 케이스)

좌표 생성

이름

난수 좌표 생성기

기능

지정된 차원 공간에서 임의의 좌표점을 생성합니다. 각 차원은 고유한 값 범위를 갖습니다. 모든 차원의 좌표 생성을 지원합니다.

매개변수

• 차원(int): 좌표 차원의 수(1D, 2D, 3D 등)
• min_values(List[float]): 각 차원의 최소값 목록
• max_values(List[float]): 각 차원의 최대값 목록
• coordinate_count(int): 생성할 좌표점 수
• salt (str, 선택 사항): 무작위성을 높이기 위한 난수 salt 값입니다. 기본값은 ''입니다.

보고

무작위 좌표를 포함하는 JSON 문자열, 형식은 다음과 같습니다.

응용 프로그램 시나리오

1. 게임 객체 위치 지정(NPC 위치, 아이템 분포)
2. 입자 시스템(효과 생성, 입자 분포)
3. 지도 생성(지형 높이, 자원 분포)
4. 공간 샘플링(3D 모델링, 공간 분석)

생성_희귀성

이름

희귀도 랜덤 할당기

기능

지정된 차원 공간에서 임의의 좌표점을 생성합니다. 각 차원은 고유한 값 범위를 갖습니다. 모든 차원의 좌표 생성을 지원합니다.

매개변수

• item_count: 프로젝트 수량
• rarity_tiers: 희귀도 레벨 배열
• rarity_percentages: 각 희귀도 레벨에 대한 확률 백분율
• guaranteed_minimums: 각 희귀도 레벨에 대해 보장되는 수량(선택 사항)
• salt (str, 선택 사항): 무작위성을 높이기 위한 난수 salt 값입니다. 기본값은 ''입니다.

보고

무작위 희귀도 배열을 포함하는 JSON 문자열, 형식은 다음과 같습니다.

응용 프로그램 시나리오

1. 게임 아이템 드랍(다양한 희귀도 장비, 아이템)
2. 복권 시스템(다양한 확률의 상금)
3. 자원 할당(다양한 희귀도 자원, 재료)
4. 무작위 이벤트 트리거(다양한 확률 이벤트)

응용 프로그램 시나리오

게임 개발

• 무작위 아이템 드롭
• 캐릭터 속성 생성
• 맵 랜덤 생성
• 확률 이벤트 트리거

재무 신청

• 위험 시뮬레이션
• 투자 포트폴리오 분석
• 시장 행동 시뮬레이션

테스트 데이터

• 무작위 테스트 케이스 생성
• 부하 테스트 데이터
• 성능 테스트 샘플

과학적 계산

• 몬테카를로 시뮬레이션
• 입자 시스템 시뮬레이션
• 무작위 표본 추출

노트

1. 모든 난수 생성은 Trust Chain의 블록체인 해시에 따라 달라지므로 정상적인 네트워크 연결을 확인하십시오.
2. 가중 난수 선택기 가중치 값 범위는 01000이며 0100% 확률을 나타냅니다.
3. 확률 분포 매개변수는 특정 분포 유형에 따라 올바른 매개변수 목록을 제공해야 합니다.
4. 무작위성을 높이기 위해 프로덕션 환경에서는 salt 매개변수를 사용하는 것이 좋습니다.

오류 처리

서비스는 다음과 같은 오류 유형을 반환할 수 있습니다.

일반적인 오류 코드:

• INVALID_PARAMS : 매개변수 오류
• NETWORK_ERROR : 네트워크 연결 오류
• CHAIN_ERROR : 블록체인 접근 오류
• INTERNAL_ERROR : 내부 서비스 오류

성능 고려 사항

• 각 난수 생성 요청은 블록체인에 액세스해야 하며, 이는 특정 지연이 있을 수 있습니다.
• 자주 사용되는 난수는 캐시하는 것이 좋습니다.
• 많은 수의 동시 요청을 처리할 때 요청 빈도에 주의하세요.

기여 가이드

이 프로젝트 개선을 위해 이슈 및 풀 리퀘스트를 제출해 주세요. 제출하기 전에 다음 사항을 확인해 주세요.

1. 코드는 PEP 8 사양을 준수합니다.
2. 적절한 테스트 케이스가 추가되었습니다.
3. 관련 문서가 업데이트되었습니다.

특허

이 프로젝트는 MIT 라이선스를 사용합니다. 자세한 내용은 라이선스 파일을 참조하세요.