random-web3-mcp
RandomWeb3MCP - Web3 랜덤 요소 생성 서비스
RandomWeb3MCP는 EVM 블록 해시 기반 난수 생성 서비스입니다. 이 서비스는 게임, 금융, 테스트 및 기타 분야에서 사용할 수 있는 다양한 난수 생성 도구를 제공합니다.
특징
검증 가능성 : 모든 난수는 블록체인 해시를 기반으로 생성되므로 공정성과 검증 가능성이 보장됩니다.
다양성 : 기본 난수부터 복잡한 확률 분포까지 다양한 난수 생성 시나리오를 지원합니다.
신뢰성 : 무작위성 품질을 보장하기 위해 엔트로피 소스로 블록체인을 사용합니다.
사용성 : 간편한 통합을 위한 간단하고 직관적인 API 인터페이스 제공
Related MCP server: Random Value MCP Server
설치
지엑스피1
빠른 시작
tico 또는 커서 구성
커서 설정에 random-web3-mcp 서비스 구성을 추가합니다.
{
"mcpServers": {
"random-web3-mcp": {
"command": "uv",
"args": ["--directory", "local_repo_directory/zxl-mcp-server", "run", "main.py"]
}
}
}도구 목록
기본_난수_생성
이름
기본 난수 생성기
기능
지정된 범위 내에서 난수 정수를 생성합니다.
매개변수
min_value(정수, 선택 사항): 최소값(포함). 기본값은 0입니다.
max_value(정수, 선택 사항): 최대값(포함). 기본값은 1000000입니다.
salt (str, 선택 사항): 무작위성을 높이기 위한 난수 salt 값입니다. 기본값은 ''입니다.
보고
난수 결과를 포함하는 JSON 문자열
응용 프로그램 시나리오
복권 시스템
게임 난수
랜덤 ID 생성
테스트 데이터 생성
난수 배열 생성
이름
난수 배열 생성기
기능
지정된 길이의 무작위 배열을 생성합니다
매개변수
array_length(정수, 선택 사항): 배열 길이입니다. 기본값은 1입니다.
min_value(정수, 선택 사항): 최소값입니다. 기본값은 0입니다.
max_value(정수, 선택 사항): 최대값입니다. 기본값은 1000000입니다.
salt(str, 선택 사항): 무작위 숫자 salt 값. 기본값은 ''입니다.
보고
난수 배열을 포함하는 JSON 문자열
응용 프로그램 시나리오
일괄 난수 생성
무작위 표본 추출
테스트 데이터 세트 생성
무작위 작업 할당
무작위 가중치 생성
이름
가중 난수 선택기
기능
가중치에 따라 무작위로 옵션을 선택합니다.
매개변수
옵션(List[str]): 옵션 목록
가중치(List[int]): 해당 가중치 목록(0-1000)
salt(str, 선택 사항): 무작위 숫자 salt 값. 기본값은 ''입니다.
보고
선택 결과를 포함하는 JSON 문자열
응용 프로그램 시나리오
복권 시스템(다양한 확률의 상금)
무작위 드롭(가중치 아이템 드롭)
업무 할당(우선순위 기반)
A/B 테스트(비율이 다른 실험 그룹)
무작위 기능 생성
이름
랜덤 피처 할당기
기능
객체에 대한 무작위 특징 값 집합을 생성합니다. 각 특징 값은 지정된 범위 내에 있습니다. 특징 값은 비트맵으로 인코딩되며, 각 특징은 8비트를 차지합니다.
매개변수
feature_count(int): 생성할 기능 수
feature_max_values(List[int]): 각 기능에 대한 최대값 목록, 길이는 feature_count와 같아야 함
salt (str, 선택 사항): 무작위성을 높이기 위한 난수 salt 값입니다. 기본값은 ''입니다.
보고
기능 값과 비트맵을 포함하는 JSON 문자열, 형식은 다음과 같습니다.
{
"requestId": "Generated request ID",
"features": [List of feature values],
"featureBitmap": Feature bitmap value
}응용 프로그램 시나리오
게임 캐릭터 속성 생성(힘, 민첩성, 지능 등)
장비 속성 무작위화(공격력, 방어력, 속도 등)
생물학적 특성 시뮬레이션(유전자, 특성 등)
무작위 장면 생성(지형, 날씨, 환경 등)
생성_분포
이름
확률 분포 난수 생성기
기능
지정된 확률 분포 유형과 매개변수에 따라 난수를 생성합니다. 다양한 일반 확률 분포를 지원합니다.
매개변수
distribution_type(int): 배포 유형:
1 = 균일 분포(매개변수: [최소값, 최대값])
2 = 정규 분포(매개변수: [평균, 표준편차])
3 = 지수 분포(매개변수: [scale_parameter])
4 = 이항 분포(매개변수: [시도 횟수, 성공 확률])
distribution_parameters (List[float]): 분포 매개변수 목록
salt (str, 선택 사항): 무작위성을 높이기 위한 난수 salt 값입니다. 기본값은 ''입니다.
보고
무작위 값과 분포 정보를 포함하는 JSON 문자열, 형식은 다음과 같습니다.
{
"requestId": "Generated request ID",
"randomValue": Generated random value,
"distributionMetadata": {
"distributionType": Distribution type,
...Distribution parameters
}
}응용 프로그램 시나리오
금융시장 시뮬레이션(수익률 분포, 위험 분석)
자연 현상 시뮬레이션(입자 분포, 노이즈 생성)
부하 테스트(사용자 행동 분포)
통계적 샘플링(실험적 데이터 생성)
무작위 이벤트 생성
이름
무작위 이벤트 트리거
기능
주어진 확률에 따라 일련의 이벤트를 트리거합니다. 각 이벤트는 독립적인 트리거 확률을 갖습니다. 비트맵을 사용하여 트리거 상태를 기록하여 쉽게 처리할 수 있습니다.
매개변수
event_count(int): 총 이벤트 수
event_probabilities(List[int]): 각 이벤트에 대한 트리거 확률(0-1000, 0-100%를 나타냄)
salt (str, 선택 사항): 무작위성을 높이기 위한 난수 salt 값입니다. 기본값은 ''입니다.
보고
이벤트 트리거 결과가 포함된 JSON 문자열(형식:
{
"requestId": "Generated request ID",
"triggeredEvents": Event trigger bitmap,
"eventResults": [
{
"eventId": Event ID,
"probability": Trigger probability,
"triggered": Whether triggered,
"randomValue": Random value
},
...
]
}응용 프로그램 시나리오
게임 무작위 이벤트(트리거 플롯, 아이템 드롭)
확률 효과 판정 (스킬 발동, 콤보 판정)
위험 이벤트 시뮬레이션(고장 예측, 사고 이벤트)
다중 조건 결정(결합 확률 이벤트)
무작위 시드 생성
이름
난수 생성기
기능
암호화 또는 고품질 난수가 필요한 기타 시나리오를 위해 고엔트로피 난수 시드를 생성합니다. 블록체인 해시를 엔트로피 소스로 사용하여 난수성을 보장합니다.
매개변수
seed_length(int): 생성할 시드의 길이(바이트)
salt (str, 선택 사항): 무작위성을 높이기 위한 난수 salt 값입니다. 기본값은 ''입니다.
보고
난수 시드를 포함하는 JSON 문자열, 형식은 다음과 같습니다.
{
"requestId": "Generated request ID",
"randomSeed": "Random seed in hexadecimal format",
"entropy": Estimated entropy value
}응용 프로그램 시나리오
키 생성(암호화 키, 서명 시드)
보안 토큰(세션 식별자, 인증 토큰)
난수 초기화(PRNG 시드, 시뮬레이션 초기 상태)
고유 식별자 생성(UUID 시드, 임의 식별자)
셔플_배열
이름
랜덤 배열 셔플러
기능
입력 배열을 무작위로 섞어 각 요소가 어떤 위치에든 나타날 확률이 동일하도록 합니다. 공정성을 보장하기 위해 Fisher-Yates 셔플 알고리즘을 사용합니다.
매개변수
input_array(리스트): 섞을 배열, 요소는 어떤 유형이든 가능
salt (str, 선택 사항): 무작위성을 높이기 위한 난수 salt 값입니다. 기본값은 ''입니다.
보고
셔플된 배열을 포함하는 JSON 문자열, 형식은 다음과 같습니다.
{
"requestId": "Generated request ID",
"shuffledArray": [Shuffled array]
}응용 프로그램 시나리오
게임 셔플링(플레잉 카드, 마작 패)
무작위 순서(질문 순서, 재생 목록)
무작위 그룹화(팀 배정, 실험 그룹화)
데이터 셔플링(훈련 데이터 세트, 테스트 케이스)
좌표 생성
이름
난수 좌표 생성기
기능
지정된 차원 공간에서 임의의 좌표점을 생성합니다. 각 차원은 고유한 값 범위를 갖습니다. 모든 차원의 좌표 생성을 지원합니다.
매개변수
차원(int): 좌표 차원의 수(1D, 2D, 3D 등)
min_values(List[float]): 각 차원의 최소값 목록
max_values(List[float]): 각 차원의 최대값 목록
coordinate_count(int): 생성할 좌표점 수
salt (str, 선택 사항): 무작위성을 높이기 위한 난수 salt 값입니다. 기본값은 ''입니다.
보고
무작위 좌표를 포함하는 JSON 문자열, 형식은 다음과 같습니다.
{
"requestId": "Generated request ID",
"coordinates": [
[x1, y1, z1, ...], # First point coordinates
[x2, y2, z2, ...], # Second point coordinates
...
]
}응용 프로그램 시나리오
게임 객체 위치 지정(NPC 위치, 아이템 분포)
입자 시스템(효과 생성, 입자 분포)
지도 생성(지형 높이, 자원 분포)
공간 샘플링(3D 모델링, 공간 분석)
생성_희귀성
이름
희귀도 랜덤 할당기
기능
지정된 차원 공간에서 임의의 좌표점을 생성합니다. 각 차원은 고유한 값 범위를 갖습니다. 모든 차원의 좌표 생성을 지원합니다.
매개변수
item_count: 프로젝트 수량
rarity_tiers: 희귀도 레벨 배열
rarity_percentages: 각 희귀도 레벨에 대한 확률 백분율
guaranteed_minimums: 각 희귀도 레벨에 대해 보장되는 수량(선택 사항)
salt (str, 선택 사항): 무작위성을 높이기 위한 난수 salt 값입니다. 기본값은 ''입니다.
보고
무작위 희귀도 배열을 포함하는 JSON 문자열, 형식은 다음과 같습니다.
{
"requestId": "Generated request ID",
"rarityDistribution": [Rarity allocation result]
}응용 프로그램 시나리오
게임 아이템 드랍(다양한 희귀도 장비, 아이템)
복권 시스템(다양한 확률의 상금)
자원 할당(다양한 희귀도 자원, 재료)
무작위 이벤트 트리거(다양한 확률 이벤트)
응용 프로그램 시나리오
게임 개발
무작위 아이템 드롭
캐릭터 속성 생성
맵 랜덤 생성
확률 이벤트 트리거
재무 신청
위험 시뮬레이션
투자 포트폴리오 분석
시장 행동 시뮬레이션
테스트 데이터
무작위 테스트 케이스 생성
부하 테스트 데이터
성능 테스트 샘플
과학적 계산
몬테카를로 시뮬레이션
입자 시스템 시뮬레이션
무작위 표본 추출
노트
모든 난수 생성은 Trust Chain의 블록체인 해시에 따라 달라지므로 정상적인 네트워크 연결을 확인하십시오.
가중 난수 선택기 가중치 값 범위는 0
1000이며 0100% 확률을 나타냅니다.확률 분포 매개변수는 특정 분포 유형에 따라 올바른 매개변수 목록을 제공해야 합니다.
무작위성을 높이기 위해 프로덕션 환경에서는 salt 매개변수를 사용하는 것이 좋습니다.
오류 처리
서비스는 다음과 같은 오류 유형을 반환할 수 있습니다.
{
"error": "Error message",
"code": "Error code",
"requestId": "Request ID"
}일반적인 오류 코드:
INVALID_PARAMS: 매개변수 오류NETWORK_ERROR: 네트워크 연결 오류CHAIN_ERROR: 블록체인 접근 오류INTERNAL_ERROR: 내부 서비스 오류
성능 고려 사항
각 난수 생성 요청은 블록체인에 액세스해야 하며, 이는 특정 지연이 있을 수 있습니다.
자주 사용되는 난수는 캐시하는 것이 좋습니다.
많은 수의 동시 요청을 처리할 때 요청 빈도에 주의하세요.
기여 가이드
이 프로젝트 개선을 위해 이슈 및 풀 리퀘스트를 제출해 주세요. 제출하기 전에 다음 사항을 확인해 주세요.
코드는 PEP 8 사양을 준수합니다.
적절한 테스트 케이스가 추가되었습니다.
관련 문서가 업데이트되었습니다.
특허
이 프로젝트는 MIT 라이선스를 사용합니다. 자세한 내용은 라이선스 파일을 참조하세요.
Available Tools
10 toolsgenerate_basic_randomA
Basic Random Number Generator
Generate a random integer within the specified range
Args:
salt (str, optional): Random number salt value for increased randomness. Defaults to "".
min_value (int, optional): Minimum value (inclusive). Defaults to 0.
max_value (int, optional): Maximum value (inclusive). Defaults to 1000000.
Returns:
str: JSON string containing the random number result
Application Scenarios:
1. Lottery systems
2. Game random numbers
3. Random ID generation
4. Test data generation
Inputs: max_value, min_value, salt.
generate_coordinateA
Random Coordinate Generator
Generate random coordinate points in a specified dimensional space, each dimension has its own value range.
Supports coordinate generation in any number of dimensions.
Args:
dimensions (int): Number of coordinate dimensions (1D, 2D, 3D, etc.)
min_values (List[float]): List of minimum values for each dimension
max_values (List[float]): List of maximum values for each dimension
coordinate_count (int): Number of coordinate points to generate
salt (str, optional): Random number salt value for increased randomness. Defaults to "".
Returns:
str: JSON string containing random coordinates, formatted as:
{
"requestId": "Generated request ID",
"coordinates": [
[x1, y1, z1, ...], # First point coordinates
[x2, y2, z2, ...], # Second point coordinates
...
]
}
Application Scenarios:
1. Game object positioning (NPC locations, item distribution)
2. Particle systems (effect generation, particle distribution)
3. Map generation (terrain height, resource distribution)
4. Spatial sampling (3D modeling, spatial analysis)
Inputs: coordinate_count (required), dimensions (required), max_values (required), min_values (required), +1 more.
generate_distributionA
Probability Distribution Random Generator
Generate random numbers according to specified probability distribution type and parameters.
Supports various common probability distributions.
Args:
distribution_type (int): Distribution type:
1 = Uniform distribution (parameters: [min_value, max_value])
2 = Normal distribution (parameters: [mean, standard_deviation])
3 = Exponential distribution (parameters: [scale_parameter])
4 = Binomial distribution (parameters: [trials, success_probability])
distribution_parameters (List[float]): Distribution parameter list
salt (str, optional): Random number salt value for increased randomness. Defaults to "".
Returns:
str: JSON string containing random value and distribution information, formatted as:
{
"requestId": "Generated request ID",
"randomValue": Generated random value,
"distributionMetadata": {
"distributionType": Distribution type,
...Distribution parameters
}
}
Application Scenarios:
1. Financial market simulation (return distribution, risk analysis)
2. Natural phenomena simulation (particle distribution, noise generation)
3. Load testing (user behavior distribution)
4. Statistical sampling (experimental data generation)
Inputs: distribution_parameters (required), distribution_type (required), salt.
generate_random_arrayA
Random Array Generator
Generate a random array of specified length
Args:
salt (str, optional): Random number salt value. Defaults to "".
array_length (int, optional): Array length. Defaults to 1.
min_value (int, optional): Minimum value. Defaults to 0.
max_value (int, optional): Maximum value. Defaults to 1000000.
allow_duplicates (bool, optional): Allow duplicate values. Defaults to True.
Returns:
str: JSON string containing the random array
Application Scenarios:
1. Batch random number generation
2. Random sampling
3. Test dataset generation
4. Random task assignment
Inputs: allow_duplicates, array_length, max_value, min_value, +1 more.
generate_random_eventA
Random Event Trigger
Trigger a series of events based on given probabilities, each event has an independent trigger probability.
Uses bitmap to record trigger status for easy processing.
Args:
event_count (int): Total number of events
event_probabilities (List[int]): Trigger probability for each event (0-1000, representing 0-100%)
salt (str, optional): Random number salt value for increased randomness. Defaults to "".
Returns:
str: JSON string containing event trigger results, formatted as:
{
"requestId": "Generated request ID",
"triggeredEvents": Event trigger bitmap,
"eventResults": [
{
"eventId": Event ID,
"probability": Trigger probability,
"triggered": Whether triggered,
"randomValue": Random value
},
...
]
}
Application Scenarios:
1. Game random events (trigger plot, drop items)
2. Probability effect determination (skill trigger, combo determination)
3. Risk event simulation (fault prediction, accident events)
4. Multiple condition determination (combined probability events)
Inputs: event_count (required), event_probabilities (required), salt.
generate_random_featureA
Random Feature Allocator
Generate a set of random feature values for objects, each feature value within its specified range.
Feature values are encoded into a bitmap, with each feature occupying 8 bits.
Args:
feature_count (int): Number of features to generate
feature_max_values (List[int]): List of maximum values for each feature, length must equal feature_count
salt (str, optional): Random number salt value for increased randomness. Defaults to "".
Returns:
str: JSON string containing feature values and bitmap, formatted as:
{
"requestId": "Generated request ID",
"features": [List of feature values],
"featureBitmap": Feature bitmap value
}
Application Scenarios:
1. Game character attribute generation (strength, agility, intelligence, etc.)
2. Equipment attribute randomization (attack, defense, speed, etc.)
3. Biological trait simulation (genes, traits, etc.)
4. Random scene generation (terrain, weather, environment, etc.)
Inputs: feature_count (required), feature_max_values (required), salt.
generate_random_seedA
Random Seed Generator
Generate high-entropy random seed for encryption or other scenarios requiring high-quality random numbers.
Uses blockchain hash as entropy source to ensure randomness.
Args:
seed_length (int): Length of seed to generate (in bytes)
salt (str, optional): Random number salt value for increased randomness. Defaults to "".
Returns:
str: JSON string containing random seed, formatted as:
{
"requestId": "Generated request ID",
"randomSeed": "Random seed in hexadecimal format",
"entropy": Estimated entropy value
}
Application Scenarios:
1. Key generation (encryption keys, signature seeds)
2. Security tokens (session identifiers, authentication tokens)
3. Random number initialization (PRNG seeds, simulation initial states)
4. Unique identifier generation (UUID seeds, random identifiers)
Inputs: seed_length (required), salt.
generate_random_weightedA
Weighted Random Selector
Randomly select an option based on weights
Args:
options (List[str]): List of options
weights (List[int]): Corresponding weight list (0-1000)
salt (str, optional): Random number salt value. Defaults to "".
Returns:
str: JSON string containing the selection result
Application Scenarios:
1. Lottery systems (prizes with different probabilities)
2. Random drops (weighted item drops)
3. Task assignment (based on priority)
4. A/B testing (experiment groups with different ratios)
Inputs: options (required), weights (required), salt.
generate_rarityC
Rarity Distributor Args: item_count: Number of items rarity_tiers: Array of rarity tiers rarity_percentages: Probability percentage for each rarity tier guaranteed_minimums: Minimum guaranteed count for each rarity tier (optional) salt: Additional entropy source
Inputs: item_count (required), rarity_percentages (required), rarity_tiers (required), guaranteed_minimums, +1 more.
shuffle_arrayA
Random Array Shuffler
Randomly shuffle the input array, ensuring each element has an equal probability of appearing in any position.
Uses Fisher-Yates shuffle algorithm to ensure fairness.
Args:
input_array (List): Array to be shuffled, elements can be of any type
salt (str, optional): Random number salt value for increased randomness. Defaults to "".
Returns:
str: JSON string containing the shuffled array, formatted as:
{
"requestId": "Generated request ID",
"shuffledArray": [Shuffled array]
}
Application Scenarios:
1. Game shuffling (playing cards, mahjong tiles)
2. Random ordering (question order, playlist)
3. Random grouping (team assignment, experiment grouping)
4. Data shuffling (training dataset, test cases)
Inputs: input_array (required), salt.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
The tools have overlapping purposes in random generation, with multiple tools generating random numbers or arrays (e.g., generate_basic_random, generate_random_array, generate_distribution). However, descriptions clarify distinctions like coordinate generation, distribution types, or weighted selection, helping agents differentiate between them. Some ambiguity remains, such as between generate_random_array and shuffle_array for array manipulation.
All tool names follow a consistent snake_case pattern with a clear 'generate_' or 'shuffle_' prefix, making them predictable and readable. The naming convention is uniform across all tools, with no mixing of styles or deviations, which aids in easy identification and usage.
With 10 tools, the count is reasonable for a random generation server, covering various aspects like basic numbers, coordinates, distributions, and shuffling. It's slightly heavy but well-scoped, as each tool addresses a specific niche in random generation without being excessive for the domain.
The toolset covers a broad range of random generation scenarios, including numbers, arrays, distributions, events, and seeds, with no obvious gaps for core functionalities. Minor gaps might include lack of tools for random string generation or more advanced statistical distributions, but the existing set supports most common use cases effectively.
Related MCP Connectors
Multi-chain wallet MCP. 18 tools: balance, swap, bridge, stake, claim. Pay-per-call USDC (x402 v2).
Chainlist MCP — registry of EVM chains
Non-custodial cross-chain crypto swap MCP — 1288+ assets, no KYC. Solana/EVM/Monero, RPC, oracle.
Related MCP Servers
- AlicenseAqualityCmaintenanceProduction-ready MCP server that provides LLMs with essential random generation abilities, including random integers, floats, choices, shuffling, and cryptographically secure tokens.7156 PyPI50MIT
- AlicenseBqualityDmaintenanceGenerates random integers within a specified range and random alphanumeric strings of specified length through MCP protocol integration.2MIT
- AlicenseAqualityDmaintenanceAn encrypted and secure random number generation server that complies with the MCP protocol, suitable for AI applications, LLMS, and other systems that require high-quality random numbers.72Apache 2.0
- AlicenseAqualityDmaintenanceMCP server providing true randomness capabilities to Claude, enabling cryptographically secure random number generation for games, decision-making, sampling, simulations, and any operation requiring genuine randomness.132MIT