D&D MCP Server

Instructions

Implementation Reference

• src/gamemaster_mcp/main.py:591-612 (handler)

  MCP tool handler for 'get_game_state'. Fetches the game state from storage and returns a formatted string summary.

  @mcp.tool
  def get_game_state() -> str:
      """Get the current game state."""
      game_state = storage.get_game_state()
      if not game_state:
          return "No game state available."
  
      state_info = f"""**Game State**
  **Campaign:** {game_state.campaign_name}
  **Session:** {game_state.current_session}
  **Location:** {game_state.current_location or 'Unknown'}
  **Date (In-Game):** {game_state.current_date_in_game or 'Unknown'}
  **Party Level:** {game_state.party_level}
  **Party Funds:** {game_state.party_funds}
  **In Combat:** {'Yes' if game_state.in_combat else 'No'}
  
  **Active Quests:** {len(game_state.active_quests)}
  
  **Notes:** {game_state.notes or 'No current notes.'}
  """
  
      return state_info

• src/gamemaster_mcp/storage.py:394-398 (helper)

  Helper method in Storage class that retrieves the current GameState object from the active campaign.

  def get_game_state(self) -> GameState | None:
      """Get the current game state."""
      if not self._current_campaign:
          return None
      return self._current_campaign.game_state

• src/gamemaster_mcp/models.py:344-357 (schema)

  Pydantic BaseModel defining the GameState data structure used by the tool.

  class GameState(BaseModel):
      """Current state of the game."""
      campaign_name: str
      current_session: int = 1
      current_date_in_game: str | None = None
      current_location: str | None = None
      active_quests: list[str] = Field(default_factory=list)
      party_level: int = 1
      party_funds: str = "0 gp"
      initiative_order: list[dict[str, Any]] = Field(default_factory=list)
      in_combat: bool = False
      current_turn: str | None = None
      notes: str = ""
      updated_at: datetime = Field(default_factory=datetime.now)