使用说明
D&D DM代理MCP服务器-阶段0
一种模型上下文协议(MCP)服务器,用于管理D&D 5e游戏机制、角色数据,并通过结构化工具和API提供DM辅助。
描述
该项目实现了D&D DM MCP服务器的第0阶段(基础机制),重点是角色管理、掷骰子机制和战斗引擎基础的基本CRUD操作。服务器为游戏大师提供了一个CLI界面,以编程方式管理他们的活动。
安装说明
先决条件
- Python 3.11或更高版本
- 依赖管理诗
安装
- 克隆存储库
- 复制
.env.example向.env并根据需要进行配置 - 安装依赖项:
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
许可证
[待添加许可证信息]
