DraCor

Provides access to DraCor API v1 through MCP, enabling corpora, plays, characters, full text, and network analyses for LLM-driven workflows.

python

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "stijn-meijers-dracor-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "requests",
        "--with",
        "pydantic",
        "--with",
        "python-multipart",
        "mcp",
        "run",
        "/path/to/dracor-mcp/dracor_mcp_fastmcp.py"
      ],
      "env": {
        "DRACOR_API_BASE_URL": "https://dracor.org/api/v1"
      }
    }
  }
}

You can deploy and run a DraCor MCP Server to let Claude and other LLMs interact with the Drama Corpora Project API. This server exposes DraCor data (plays, corpora, character networks, full text, and more) through the MCP interface, enabling you to perform structured queries, analyses, and comparisons across dramatic works with ease.

How to use

Use an MCP client to connect to the DraCor MCP server and send queries that request corpora, plays, character networks, and full-text analyses. You can leverage tools to search, compare, and analyze plays, then request outputs in CSV, GEXF, GraphML, or plain text formats for reporting and visualization. Typical workflows include fetching metadata for a corpus, retrieving full text for a play, analyzing character networks, and performing comparative analyses across plays.

How to install

Prerequisites: Python 3.10 or higher and UV package manager.

pip install uv

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .

Additional sections

Claude configuration, development mode, and Docker options are provided to run and test the MCP server in different environments. You can configure Claude to load the DraCor MCP server with the included dependencies and a specific DraCor API base URL. Use the development mode to test tools and resources interactively, and opt for Docker to containerize the server for consistent deployments.

Available tools

search_plays

Search for plays based on a query, returning matching plays and metadata.

compare_plays

Compare two plays in terms of metrics and structure.

analyze_character_relations

Analyze character relationships within a single play.

analyze_play_structure

Analyze the structural elements of a play (acts, scenes, dialogue distribution).

find_character_across_plays

Find occurrences of a character across multiple plays.

analyze_full_text

Analyze the full text of a play, including dialogue and stage directions.

Built by

VeilStrat

AI signals for GTM teams