DraCor MCP Server

Instructions

Implementation Reference

• dracor_mcp_fastmcp.py:655-747 (handler)

  The complete implementation of the 'analyze_full_text' tool. Includes the @mcp.tool decorator for registration and the full handler function that analyzes the play's TEI XML structure (acts, scenes, speeches, stage directions), metadata, characters, plain text stats, and returns a comprehensive dictionary with the analysis.

  @mcp.tool("analyze_full_text")
  def analyze_full_text(corpus_name: str, play_name: str) -> Dict:
      """Analyze the full text of a play, including dialogue and stage directions."""
      try:
          # Get the TEI XML as primary source
          tei_result = get_tei_text(corpus_name, play_name)
          if "error" in tei_result:
              # Fall back to the plain text if TEI fails
              full_text = get_full_text(corpus_name, play_name)
              if "error" in full_text:
                  return {"error": full_text["error"]}
              has_tei = False
              text_content = full_text["text"]
          else:
              has_tei = True
              tei_text = tei_result["tei_text"]
              
              # Simple XML parsing to extract basic structure
              # In a production environment, use a proper XML parser library
              import re
              
              # Extract title
              title_match = re.search(r'<title[^>]*>([^<]+)</title>', tei_text)
              title = title_match.group(1) if title_match else "Unknown"
              
              # Extract author(s)
              author_matches = re.findall(r'<author[^>]*>([^<]+)</author>', tei_text)
              authors = author_matches if author_matches else ["Unknown"]
              
              # Extract acts
              acts = re.findall(r'<div type="act"[^>]*>(.*?)</div>', tei_text, re.DOTALL)
              act_count = len(acts)
              
              # Extract scenes
              scenes = re.findall(r'<div type="scene"[^>]*>(.*?)</div>', tei_text, re.DOTALL)
              scene_count = len(scenes)
              
              # Extract speeches
              speeches = re.findall(r'<sp[^>]*>(.*?)</sp>', tei_text, re.DOTALL)
              speech_count = len(speeches)
              
              # Extract stage directions
              stage_directions = re.findall(r'<stage[^>]*>(.*?)</stage>', tei_text, re.DOTALL)
              stage_direction_count = len(stage_directions)
              
              # Also get the plain text for easier processing
              full_text = get_full_text(corpus_name, play_name)
              text_content = full_text.get("text", "")
              
          # Get play metadata
          play_info = get_play(corpus_name, play_name)
          if "error" in play_info:
              return {"error": play_info["error"]}
              
          # Get character list
          characters = get_characters(corpus_name, play_name)
          if "error" in characters:
              return {"error": characters["error"]}
          
          result = {
              "play": play_info.get("play", {}),
              "characters": characters.get("characters", []),
              "text": text_content,
          }
          
          # Add TEI-specific analysis if available
          if has_tei:
              result["tei_analysis"] = {
                  "title": title,
                  "authors": authors,
                  "structure": {
                      "acts": act_count,
                      "scenes": scene_count,
                      "speeches": speech_count,
                      "stage_directions": stage_direction_count
                  },
                  "text_sample": {
                      "first_speech": speeches[0] if speeches else "",
                      "first_stage_direction": stage_directions[0] if stage_directions else ""
                  }
              }
          
          # Add basic text analysis in either case
          result["analysis"] = {
              "text_length": len(text_content),
              "character_count": len(characters.get("characters", [])),
              "dialogue_to_direction_ratio": text_content.count("\n\nDIALOGUE:") / 
                                            (text_content.count("\n\nSTAGE DIRECTIONS:") or 1)
          }
          
          return result
      except Exception as e:
          return {"error": str(e)}

• dracor_mcp_fastmcp.py:655-655 (registration)

  The MCP tool registration decorator specifically naming this tool 'analyze_full_text'.

  @mcp.tool("analyze_full_text")