D&D MCP Server

Instructions

Implementation Reference

• src/gamemaster_mcp/main.py:393-414 (handler)

  The primary handler function for the 'get_npc' MCP tool. Registered via @mcp.tool decorator. Retrieves NPC data from storage and returns formatted string information.

  @mcp.tool
  def get_npc(
      name: Annotated[str, Field(description="NPC name")]
  ) -> str:
      """Get NPC information."""
      npc = storage.get_npc(name)
      if not npc:
          return f"NPC '{name}' not found."
  
      npc_info = f"""**{npc.name}** (`{npc.id}`)
  **Race:** {npc.race or 'Unknown'}
  **Occupation:** {npc.occupation or 'Unknown'}
  **Location:** {npc.location or 'Unknown'}
  **Attitude:** {npc.attitude or 'Neutral'}
  
  **Description:** {npc.description or 'No description available.'}
  **Bio:** {npc.bio or 'No bio available.'}
  
  **Notes:** {npc.notes or 'No additional notes.'}
  """
  
      return npc_info

• src/gamemaster_mcp/storage.py:311-316 (helper)

  Helper method in DnDStorage class that retrieves an NPC object by name from the current campaign's NPC dictionary.

  def get_npc(self, name: str) -> NPC | None:
      """Get an NPC by name."""
      if not self._current_campaign:
          return None
      return self._current_campaign.npcs.get(name)

• src/gamemaster_mcp/main.py:395-396 (schema)

  Input schema definition using Pydantic Annotated and Field for the 'name' parameter.

      name: Annotated[str, Field(description="NPC name")]
  ) -> str:

• src/gamemaster_mcp/main.py:393-393 (registration)

  Tool registration decorator @mcp.tool applied to the get_npc function.

  @mcp.tool