🎲 d20-mcp（注：d20通常指二十面骰子，在此可能是一个特定游戏或系统中的术语，mcp可能指某种角色、模式或配置，具体含义需根据上下文确定，此处直译为“二十面骰子-mcp”）
土耳其（Türkiye） 点击此处获取土耳其语版README
非常适合《龙与地下城》（D&D）、《开拓者》（Pathfinder）以及任何使用标准骰子记法的桌面角色扮演游戏！
✨ 特点/功能
- 🎯 简易寿司卷快速
1d20+5即时见效的表达方式 - 📊 详细分析查看每个骰子掷出的结果，并附带AST（可能是指某种分析或统计技术）的详细分解
- ⚡ 批量滚动高效地滚动多个表达式
- ✅ 语法验证在滚动之前检查表达式
- 🎮 高级机制保留/舍弃，重新掷骰，爆炸骰（即掷出最大值时可继续掷并累加），等等
- 🤖 优化后的大型语言模型（LLM）用于人工智能理解的全面工具描述
🚀 快速入门
轻松设置（远程MCP）
使用d20-mcp的最快方法——无需安装！
- 打开Claude桌面版
- 首选 设置 → 连接器
- 点击 添加自定义连接器
- 输入网址：
https://d20-mcp.fastmcp.app/mcp
注远程MCP支持目前正处于测试阶段，适用于Claude Pro、Max、Team和Enterprise用户。
本地安装（替代方案）
对于使用uvx的本地安装：
uvx --from git+https://github.com/saidsurucu/d20-mcp d20-mcpClaude 桌面配置（本地）
把这个加到你的（清单/列表/计划等）里 claude_desktop_config.json:
macOS（苹果电脑操作系统）: ~/Library/Application Support/Claude/claude_desktop_config.json Windows（视窗操作系统）: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"d20-mcp": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/saidsurucu/d20-mcp",
"d20-mcp"
]
}
}
}完全重启Claude桌面应用（退出后重新打开），然后寻找🔨锤子图标！
📸 截图
🎮 使用示例
安装完成后，尝试在Claude上使用这些提示：
基本滚动
Roll 1d20+5 for my attack角色创建
Roll 6 sets of 4d6kh3 for ability scores战斗
Roll attack (1d20+7) and damage (2d8+4) for my greatsword凭借优势
Roll 2d20kh1+5 for my Perception check with advantage复杂表达式
Roll (1d4+1)*2 for Magic Missile damage🛠️ 可用工具
roll
快速掷骰，即时返回总和及格式化结果。非常适合标准游戏玩法。
用于攻击检定、能力检定、伤害、豁免检定
roll_detailed
带有AST（抽象语法树）结构的全面分解，展示单个芯片的值和操作。
用于角色创建，复杂滚动（或复杂操作）的调试，透明度
roll_batch
在一次操作中滚动多个不同的表达式。
用于战斗回合，所有属性值掷骰决定，团队检定
validate_syntax
验证表达式，不进行滚动（无随机性）。
用于测试复杂表达式，用户输入验证
📝 支持的骰子表示法
基本
1d20- 掷一个20面骰子3d6- 掷三个六面骰子d20- 等同于1d20（掷一个20面骰子）
保留/删除
4d6kh3- 保留最高的3个4d6kl1- 保留最低的1个4d6p1- 去掉最低的1个（分数/成绩等）
重新掷骰（或重新尝试）
1d20rr<10- 重新掷直到≥101d20ro1- 重新掷一次1
爆炸骰子
1d6e- 在最大值时爆炸1d6e6- 在6时爆炸
最小值/最大值
1d20mi10- 至少101d20ma20- 最多20
算术
1d20+5- 加法2d6-1- 减法3d6*2- 乘法(1d4+1)*2- 括号
高级
2d20kh1+5- 在Dungeons & Dragons（龙与地下城）中的优势2d20kl1+2- 缺点8d6 [fire]- 标注的损伤（带allow_comments）
🎯 常见的角色扮演游戏（RPG）应用场景
《龙与地下城》第五版角色创建
Roll me 6 ability scores using 4d6 keep highest 3以优势发起攻击
I have advantage on this attack. Roll 2d20kh1+8暴击
I crit! Roll 4d6+2d6+5 for my sneak attack damage多次保存
Roll saves for 4 party members: 1d20+5, 1d20+2, 1d20+7, 1d20+3🔧 开发
本地测试
# Clone the repository
git clone https://github.com/saidsurucu/d20-mcp.git
cd d20-mcp
# Run with uv
uv run server.py
# Or with Python directly (after installing dependencies)
python server.py项目结构
d20-mcp/
├── server.py # Main MCP server with 4 tools
├── pyproject.toml # Project configuration
├── README.md # English documentation
├── README.tr.md # Turkish documentation
└── LICENSE # MIT License🤝 贡献（或“参与贡献”）
欢迎投稿！请随时：
- 报告错误
- 建议新功能
- 提交拉取请求
- 改进文档
📄 许可证
MIT 许可证 - 详见 许可证 详情请见文件。
🙏 致谢
构建于：
- d20 - 强大的骰子掷出引擎
- FastMCP - FastMCP框架
- MCP可以翻译为“最小化细胞程序化死亡”（在生物学或医学领域，具体含义可能根据上下文有所不同，但此处提供一个通用的翻译）。不过，MCP也可能有其他含义，具体需要根据上下文来确定。在某些情况下，MCP可能是一个缩写或特定术语，代表不同的概念或缩写。因此，在翻译时需要考虑具体的语境和领域 - 模型上下文协议
📚 了解更多
______________________________________________________________________
为TTRPG（桌面角色扮演游戏）社区用心打造