D&D游戏管理服务器

一个用于管理D&D 5e游戏机制、角色数据并通过结构化工具和API提供DM辅助的模型上下文协议(MCP)服务器。

  • by aibozo
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 aibozo/dnd-mcp

使用说明

D&D DM代理MCP服务器-阶段0

一种模型上下文协议(MCP)服务器,用于管理D&D 5e游戏机制、角色数据,并通过结构化工具和API提供DM辅助。

描述

该项目实现了D&D DM MCP服务器的第0阶段(基础机制),重点是角色管理、掷骰子机制和战斗引擎基础的基本CRUD操作。服务器为游戏大师提供了一个CLI界面,以编程方式管理他们的活动。

安装说明

先决条件

  • Python 3.11或更高版本
  • 依赖管理诗

安装

  1. 克隆存储库
  2. 复制 .env.example 向 .env 并根据需要进行配置
  3. 安装依赖项:
    poetry install
    

运行服务器

poetry run python -m src.main

CLI使用示例

角色管理

# Create a new character
poetry run python -m src.cli character create --name "Gandalf" --class "Wizard" --level 5

# List all characters
poetry run python -m src.cli character list

# Get character details
poetry run python -m src.cli character get --name "Gandalf"

# Update character
poetry run python -m src.cli character update --name "Gandalf" --level 6

# Delete character
poetry run python -m src.cli character delete --name "Gandalf"

掷骰子

# Roll dice
poetry run python -m src.cli roll 1d20+5
poetry run python -m src.cli roll 3d6

战斗引擎

# Start combat session
poetry run python -m src.cli combat start

# Add combatants
poetry run python -m src.cli combat add --name "Gandalf" --initiative 15

# Process turn
poetry run python -m src.cli combat turn

发展

运行测试:

poetry run pytest

许可证

[待添加许可证信息]