D&D MCP Server

Instructions

Implementation Reference

• src/gamemaster_mcp/main.py:698-713 (handler)

  The MCP tool handler for 'get_sessions'. Decorated with @mcp.tool, it retrieves session notes from storage, formats them into a markdown-formatted string list sorted by session number, and returns it. This is both the handler logic and registration point.

  @mcp.tool
  def get_sessions() -> str:
      """Get all session notes."""
      sessions = storage.get_sessions()
      if not sessions:
          return "No session notes recorded."
  
      session_list = []
      for session in sorted(sessions, key=lambda s: s.session_number):
          title = session.title or "No title"
          date = session.date.strftime("%Y-%m-%d")
          session_list.append(f"**Session {session.session_number}** ({date}): {title}")
          session_list.append(f"  {session.summary[:100]}{'...' if len(session.summary) > 100 else ''}")
          session_list.append("")
  
      return "**Session Notes:**\n\n" + "\n".join(session_list)

• src/gamemaster_mcp/storage.py:410-414 (helper)

  Core helper method in the Storage class that returns the list of SessionNote objects from the current campaign's sessions attribute.

  def get_sessions(self) -> list[SessionNote]:
      """Get all session notes."""
      if not self._current_campaign:
          return []
      return self._current_campaign.sessions

• src/gamemaster_mcp/models.py:330-342 (schema)

  Pydantic model defining the structure of each SessionNote object returned by the storage helper and used in the tool handler.

  class SessionNote(BaseModel):
      """Session notes and summary."""
      id: str = Field(default_factory=lambda: random(length=8))
      session_number: int
      date: datetime = Field(default_factory=datetime.now)
      title: str | None = None
      summary: str
      events: list[str] = Field(default_factory=list)
      characters_present: list[str] = Field(default_factory=list)
      experience_gained: int | None = None
      treasure_found: list[str] = Field(default_factory=list)
      notes: str = ""