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