D&D 5e MCP服务器
*你的个人AI地牢主引擎*
这是一个专业 模型上下文协议（MCP） 服务器，将您的AI助手（如克劳德桌面）变成D&D第五版单人游戏中功能齐全的地牢大师。
它是如何工作的： 人工智能告诉了这个故事，但是 此服务器 处理规则。它掷骰子，跟踪你的HP，管理你的库存，并记住你在哪里，所以AI可以专注于成为一个伟大的说书人。
______________________________________________________________________
作者：Gwyneth和Gemini 3 Pro（在反重力制剂中）和GLM 4.6（在临床制剂中）
🚀 入门指南（适用于姻亲和朋友！）
1.先决条件
你需要一个支持MCP的AI接口，比如 克劳德桌面版.
2.安装
- 下载此文件夹 到你的电脑。
- 打开您的AI客户端配置（例如。，
claude_desktop_config.json). - 添加
dnd-server根据您的配置：
{
"mcpServers": {
"dnd-server": {
"command": "python3",
"args": ["-m", "dnd_mcp_server.server"],
"env": {
"PYTHONPATH": "/absolute/path/to/this/folder"
}
}
}
}*（确保更换 /absolute/path/... 保存此文件夹的真实路径！)*
3.如何玩
- 打开你的AI聊天。
- 复制并粘贴 全文来自
system_prompt.md加入聊天。
- *专业提示：如果您的客户端支持MCP Prompts（如Claude Desktop），只需键入 / 并选择 dnd_dm!* - *提示：这告诉人工智能如何使用其新的研发超级能力。*
- 开始说话！
- *“我想创造一个新角色。我将成为一个名叫加里克的人类战士。”* - *“我探索黑暗的洞穴。”* - *“我用长剑攻击地精！”*
______________________________________________________________________
✨ 特性
- 持久的世界：你的角色、战利品和进度会自动保存。结束聊天，明天再来，从你停止的地方继续。
- 真正的D&D规则:
- 战斗：主动性、AC、攻击滚和伤害是使用实5e数学计算的。 - 休息：短暂休息使用Hit Dice治愈你。长时间休息可以恢复一切。 - 调平：获得经验值并升级以变得更强。
- 无限内容:
- 立即遇到5e SRD中的任何怪物（地精、龙、巫妖）。 - 无需输入统计数据，即可找到任何魔法物品（火舌、包）。
- 多活动支持：同时进行多个不同的冒险。只需给每个人一个唯一的名称（例如“Gwyn's Campaign”、“Test Run”），服务器就会将他们的保存文件分开。
- 会话连续性：服务器记住发生了什么！AI DM可以保存/加载会话摘要，以准确地从您停止的地方继续故事。
- 经济：追踪黄金、购买物品和管理财富(
add_gold,remove_gold).
🗺️ 路线图
基于全面的测试和用户反馈，以下是我们使5e MCP服务器更好的开发路线图：
🔄 API整合（v1.1）✅ 完成
目标：将工具数量从约35个减少到约25个，以实现更清洁、更高效的交互
- \[x\] 合并
update_hp和deal_damage统一update_hp(amount, type, target_id, campaign_id) - \[x\] 合并
make_skill_check和make_ability_check进入make_check(check_type, skill_or_ability, ...) - \[x\] 将升级检测集成到
add_experience消除单独的XP检查 - \[x\] 流线型
add_item+equip_item新战利品的工作流程equip_to_slot参数 - \[x\] 评估
prepare_spell必要性vscast_spell插槽跟踪-集成prepare参数
🤖 小型LLM兼容性（v1.2）✅ 完成
目标：使用本地7B-13B型号实现可靠运行
- \[x\] 在每个工具描述中添加单镜头示例
- \[x\] 为常见序列（战斗、休息、升级）创建工作流程指南
- \[x\] 实现客户端JSON模式验证
- \[x\] 将工具描述简化为每个\<50个单词
- \[x\] 添加带有有用错误消息的约束/验证层
+++++++替换
📚 文档增强功能（v1.1）
目标：澄清边缘案例并改进DM指导
- \[\]记录临时HP损坏吸收规则
- \[\]澄清法术准备与施放机制
- \[\]添加条件持续时间跟踪文档
- \[\]指定活动ID命名约定（字母数字+下划线）
- \[\]添加死亡保存恢复路径文档
- \[\]创建带有分步示例的“通用工作流”部分
🐛 Bug修复和波兰语（v1.0.1）
目标：解决综合测试期间发现的问题
- \[\]修复HP显示错误（妖精显示187 HP而不是~7）
- \[\]改进计划订单格式（添加索引：“Goblin#1”、“Goblin#2”）
- \[\]验证怪物初始化不会意外缩放HP
- \[\]测试法术槽消耗和恢复机制
- \[\]验证浓度跟踪功能
✨ 新功能（v1.3）
目标：根据用户反馈增加生活质量改进
- \[\]实施
generate_loot(monster_name, campaign_id)辅助工具 - \[\]为带有持续时间计时器的条件添加自动过期功能
- \[\]使用模拟向导角色创建全面的测试套件
- \[\]添加基于怪物CR和宝表的战利品生成
- \[\]对多角色活动实施党的管理
🚀 性能和稳定性（v1.4）
目标：优化生产使用
- \[\]添加全面的错误处理和恢复
- \[\]在所有入口点实施数据验证
- \[\]优化大型活动的保存/加载性能
- \[\]添加备份和迁移工具以保存数据
- \[\]创建自动化测试管道
🎯 伸展目标（v2.0）
目标：高级用户的高级功能
- \[\]多角色派对支持
- \[\]自定义怪物和物品创建工具
- \[\]活动导入/导出（JSON、Markdown）
- \[\]与外部VTT平台集成
- \[\]Homebrew内容支持系统
______________________________________________________________________
备注：版本号是暂定的，可能会根据开发优先级而变化。社区反馈和贡献将有助于制定最终路线图！
🛠️ 工具备忘单
（人工智能会自动使用这些，但很高兴知道引擎盖下发生了什么！）
| 类别 | 工具 | 它的作用 |
|---|---|---|
| 行动 | make_check | 统一的技能/能力检查（例如。 make_check("skill", "athletics")) |
| 战斗 | start_combat | 繁殖怪物并提高主动性。 |
| 战斗 | make_attack | 翻滚击中AC。如果成功，你会造成伤害。 |
| 角色 | get_character_sheet | 读取您当前的HP、XP和统计数据。 |
| 角色 | update_hp | 角色或战斗目标的统一伤害/治愈/临时生命值。 |
| 魔法 | cast_spell | 使用法术槽，跟踪注意力，可以准备法术。 |
| 休息 | rest | 执行短期或长期休息以恢复资源。 |
| 状态 | manage_conditions | 应用或删除“Prone”或“Exhaustion”等条件。 |
| 库存 | add_item | 添加项目，并可选择在一个步骤中装备它们。 |
| 经济 | add_gold | 将黄金添加到您的库存中。 |
🎲 单人平衡
该系统已针对 一个玩家.
- 英雄等级你是主角。死亡拯救是戏剧性的。
- 公平的战斗：AI被指示建立平衡的遭遇战（一对一决斗或一小群弱小的敌人）。
______________________________________________________________________
*冒险快乐！*