DraCor MCP Server

Instructions

Implementation Reference

• dracor_mcp_fastmcp.py:621-653 (handler)

  The handler function decorated with @mcp.tool() that implements the logic to find occurrences of a character across all plays in all corpora by querying the DraCor API for corpora, plays, and characters, matching by name (case-insensitive), and collecting relevant metadata.

  @mcp.tool()
  def find_character_across_plays(character_name: str) -> Dict:
      """Find a character across multiple plays in the DraCor database."""
      try:
          all_corpora = api_request("corpora")
          matches = []
          
          for corpus in all_corpora:
              corpus_name = corpus["name"]
              corpus_data = api_request(f"corpora/{corpus_name}")
              
              for play in corpus_data.get("plays", []):
                  play_name = play.get("name")
                  
                  try:
                      characters = api_request(f"corpora/{corpus_name}/plays/{play_name}/characters")
                      
                      for character in characters:
                          if character_name.lower() in (character.get("name") or "").lower():
                              matches.append({
                                  "corpus": corpus_name,
                                  "play": play.get("title"),
                                  "character": character.get("name"),
                                  "gender": character.get("gender"),
                                  "numOfSpeechActs": character.get("numOfSpeechActs"),
                                  "numOfWords": character.get("numOfWords")
                              })
                  except:
                      continue
          
          return {"matches": matches}
      except Exception as e:
          return {"error": str(e)}

• dracor_mcp_fastmcp.py:621-621 (registration)

  The @mcp.tool() decorator registers the find_character_across_plays function as an MCP tool.

  @mcp.tool()