RandomWeb3MCP-Web3随机元素生成服务
RandomWeb3MCP是一种基于EVM块哈希的随机元素生成服务。该服务提供了各种随机元素生成工具，可用于游戏、金融、测试和其他领域。
特性
- 可验证性：所有随机数均基于区块链哈希生成，确保公平性和可验证性
- 多样性：支持从基本随机数到复杂概率分布的各种随机数生成场景
- 可靠性：使用区块链作为熵源，以确保随机性质量
- 可用性：提供简单直观的API接口，便于集成
安装
git clone git@github.com:suxiongye/random-web3-mcp.git
pip install -e .快速开始
tico或Cursor中的配置
在游标设置中添加random-web3-mcp服务配置：
{
"mcpServers": {
"random-web3-mcp": {
"command": "uv",
"args": ["--directory", "local_repo_directory/zxl-mcp-server", "run", "main.py"]
}
}
}刀具清单
generate_basic_random
名字
基本随机数生成器
函数
生成指定范围内的随机整数
参数
- min_value（int，可选）：最小值（含）。默认为0。
- max_value（int，可选）：最大值（含）。默认值为1000000。
- salt（str，可选）：随机数盐值，用于增加随机性。默认为“”
退货
包含随机数结果的JSON字符串
应用场景
- 彩票系统
- 游戏随机数
- 随机ID生成
- 测试数据生成
generate_random_array
名字
随机阵列生成器
函数
生成指定长度的随机数组
参数
- array_length（int，可选）：数组长度。默认为1。
- min_value（int，可选）：最小值。默认为0。
- max_value（int，可选）：最大值。默认值为1000000。
- salt（str，可选）：随机数盐值。默认为“”
退货
包含随机数组的JSON字符串
应用场景
- 批量随机数生成
- 随机抽样
- 测试数据集生成
- 随机任务分配
发电机随机加权
名字
加权随机选择器
函数
根据权重随机选择一个选项
参数
- options（List\[str\]）：选项列表
- weights（List\[int\]）：对应的权重列表（0-1000）
- salt（str，可选）：随机数盐值。默认为“”
退货
包含选择结果的JSON字符串
应用场景
- 彩票系统（不同概率的奖品）
- 随机掉落（加权物品掉落）
- 任务分配（基于优先级）
- A/B测试（不同比例的实验组）
generate_random_特征
名字
随机特征分配器
函数
为对象生成一组随机特征值，每个特征值都在其指定范围内。特征值被编码为位图，每个特征占用8位
参数
- feature_count（int）：要生成的特征数
- feature_max_values（List\[int\]）：每个特征的最大值列表，长度必须等于feature_count
- salt（str，可选）：随机数盐值，用于增加随机性。默认为“”
退货
包含特征值和位图的JSON字符串，格式为：
{
"requestId": "Generated request ID",
"features": [List of feature values],
"featureBitmap": Feature bitmap value
}应用场景
- 游戏角色属性生成（力量、敏捷性、智力等）
- 装备属性随机化（攻击、防御、速度等）
- 生物性状模拟（基因、性状等）
- 随机场景生成（地形、天气、环境等）
发电机分配
名字
概率分布随机生成器
函数
根据指定的概率分布类型和参数生成随机数。支持各种常见的概率分布。
参数
- distribution_type（int）：分发类型：
- 1=均匀分布（参数：\[min_value，max_value\]） - 2=正态分布（参数：\[平均值，标准偏差\]） - 3=指数分布（参数：\[scale_parameter\]） - 4=二项式分布（参数：\[试验，成功概率\]）
- distribution_parameters（列表\[float\]）：分布参数列表
- salt（str，可选）：随机数盐值，用于增加随机性。默认为“”
退货
包含随机值和分布信息的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，可选）：随机数盐值，用于增加随机性。默认为“”
退货
包含事件触发结果的JSON字符串，格式如下：
{
"requestId": "Generated request ID",
"triggeredEvents": Event trigger bitmap,
"eventResults": [
{
"eventId": Event ID,
"probability": Trigger probability,
"triggered": Whether triggered,
"randomValue": Random value
},
...
]
}应用场景
- 游戏随机事件（触发情节、投掷物品）
- 概率效应确定（技能触发、组合确定）
- 风险事件模拟（故障预测、事故事件）
- 多条件确定（组合概率事件）
generate_random_set
名字
随机种子生成器
函数
生成高熵随机种子，用于加密或其他需要高质量随机数的场景。使用区块链哈希作为熵源，以确保随机性。
参数
- seed_length（int）：要生成的种子长度（以字节为单位）
- salt（str，可选）：随机数盐值，用于增加随机性。默认为“”
退货
包含随机种子的JSON字符串，格式为：
{
"requestId": "Generated request ID",
"randomSeed": "Random seed in hexadecimal format",
"entropy": Estimated entropy value
}应用场景
- 密钥生成（加密密钥、签名种子）
- 安全令牌（会话标识符、身份验证令牌）
- 随机数初始化（PRNG种子、模拟初始状态）
- 唯一标识符生成（UUID种子、随机标识符）
shuffle_array
名字
随机阵列洗牌器
函数
随机洗牌输入数组，确保每个元素出现在任何位置的概率相等。使用Fisher-Yates洗牌算法来确保公平性。
参数
- input_array（List）：要混洗的数组，元素可以是任何类型
- salt（str，可选）：随机数盐值，用于增加随机性。默认为“”
退货
包含混洗数组的JSON字符串，格式如下：
{
"requestId": "Generated request ID",
"shuffledArray": [Shuffled array]
}应用场景
- 游戏洗牌（扑克牌、麻将牌）
- 随机排序（问题顺序、播放列表）
- 随机分组（团队分配、实验分组）
- 数据洗牌（训练数据集、测试用例）
生成坐标
名字
随机坐标生成器
函数
在指定的维度空间中生成随机坐标点，每个维度都有自己的值范围。支持在任意数量的维度中生成坐标。
参数
- dimensions（int）：坐标维度的数量（1D、2D、3D等）
- min_values（List\[float\]）：每个维度的最小值列表
- max_values（List\[float\]）：每个维度的最大值列表
- coordinate_count（int）：要生成的坐标点数量
- salt（str，可选）：随机数盐值，用于增加随机性。默认为“”
退货
包含随机坐标的JSON字符串，格式为：
{
"requestId": "Generated request ID",
"coordinates": [
[x1, y1, z1, ...], # First point coordinates
[x2, y2, z2, ...], # Second point coordinates
...
]
}应用场景
- 游戏对象定位（NPC位置、物品分布）
- 粒子系统（效果生成、粒子分布）
- 地图生成（地形高度、资源分布）
- 空间采样（三维建模、空间分析）
generate_稀有性
名字
稀有随机分配器
函数
在指定的维度空间中生成随机坐标点，每个维度都有自己的值范围。支持在任意数量的维度中生成坐标。
参数
- item_count：工程量
- rarity_tiers：稀有级别数组
- 稀有性百分比：每个稀有性级别的概率百分比
- 保证_最小值：每个稀有级别的保证数量（可选）
- salt（str，可选）：随机数盐值，用于增加随机性。默认为“”
退货
包含随机稀有性数组的JSON字符串，格式为：
{
"requestId": "Generated request ID",
"rarityDistribution": [Rarity allocation result]
}应用场景
- 游戏物品掉落（不同稀有装备、物品）
- 彩票系统（不同概率的奖品）
- 资源配置（不同稀有资源、材料）
- 随机事件触发（不同概率事件）
应用场景
游戏开发
- 随机物品掉落
- 角色属性生成
- 地图随机生成
- 概率事件触发器
金融应用
- 风险模拟
- 投资组合分析
- 市场行为模拟
测试数据
- 随机测试用例生成
- 负载测试数据
- 性能测试样本
科学计算
- 蒙特卡罗模拟
- 粒子系统仿真
- 随机抽样
备注
- 所有随机数的生成都依赖于信任链的区块链哈希，请确保网络连接正常
- 加权随机选择器权重值范围为0-1000，表示0-100%的概率
- 概率分布参数需要根据特定的分布类型提供正确的参数列表
- 建议在生产环境中使用盐参数，以增加随机性
错误处理
服务可能会返回错误类型：
{
"error": "Error message",
"code": "Error code",
"requestId": "Request ID"
}常见错误代码：
INVALID_PARAMS：参数错误NETWORK_ERROR：网络连接错误CHAIN_ERROR：区块链访问错误INTERNAL_ERROR：内部服务错误
性能考虑
- 每个随机数生成请求都需要访问区块链，这可能会有一定的延迟
- 建议缓存常用的随机数
- 处理大量并发请求时注意请求频率
贡献指南
欢迎提交问题和拉取请求以帮助改进此项目。提交前，请确保：
- 代码符合PEP 8规范
- 添加了适当的测试用例
- 相关文件已更新
许可证
该项目使用MIT许可证。看 许可证 文件以获取详细信息。