5e MCP

D&D 5e MCP服务器

*你的个人AI地牢主引擎*

这是一个专业 模型上下文协议（MCP） 服务器，将您的AI助手（如克劳德桌面）变成D&D第五版单人游戏中功能齐全的地牢大师。

它是如何工作的： 人工智能告诉了这个故事，但是 此服务器 处理规则。它掷骰子，跟踪你的HP，管理你的库存，并记住你在哪里，所以AI可以专注于成为一个伟大的说书人。

______________________________________________________________________

作者：Gwyneth和Gemini 3 Pro（在反重力制剂中）和GLM 4.6（在临床制剂中）

🚀 入门指南（适用于姻亲和朋友！）

1.先决条件

你需要一个支持MCP的AI接口，比如 克劳德桌面版.

2.安装

1. 下载此文件夹 到你的电脑。
2. 打开您的AI客户端配置（例如。， claude_desktop_config.json).
3. 添加 dnd-server 根据您的配置：

{
  "mcpServers": {
    "dnd-server": {
      "command": "python3",
      "args": ["-m", "dnd_mcp_server.server"],
      "env": {
        "PYTHONPATH": "/absolute/path/to/this/folder" 
      }
    }
  }
}

*（确保更换 /absolute/path/... 保存此文件夹的真实路径！)*

3.如何玩

1. 打开你的AI聊天。
2. 复制并粘贴 全文来自 system_prompt.md 加入聊天。

- *专业提示：如果您的客户端支持MCP Prompts（如Claude Desktop），只需键入 / 并选择 dnd_dm!* - *提示：这告诉人工智能如何使用其新的研发超级能力。*

1. 开始说话！

- *“我想创造一个新角色。我将成为一个名叫加里克的人类战士。”* - *“我探索黑暗的洞穴。”* - *“我用长剑攻击地精！”*

______________________________________________________________________

✨ 特性

• 持久的世界：你的角色、战利品和进度会自动保存。结束聊天，明天再来，从你停止的地方继续。
• 真正的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 必要性vs cast_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内容支持系统

______________________________________________________________________

备注：版本号是暂定的，可能会根据开发优先级而变化。社区反馈和贡献将有助于制定最终路线图！

🛠️ 工具备忘单

（人工智能会自动使用这些，但很高兴知道引擎盖下发生了什么！）

🎲 单人平衡

该系统已针对 一个玩家.

• 英雄等级你是主角。死亡拯救是戏剧性的。
• 公平的战斗：AI被指示建立平衡的遭遇战（一对一决斗或一小群弱小的敌人）。

______________________________________________________________________

*冒险快乐！*