DraCor MCP サーバー

Drama Corpora Project (DraCor) APIと連携するためのモデルコンテキストプロトコル（MCP）サーバー。このMCPサーバーを使用すると、Claudeやその他のLLMを通じて、劇作テキストとその登場人物ネットワークをシームレスに分析できます。

概要

このプロジェクトは、DraCor API v1へのアクセスを提供する公式モデルコンテキストプロトコルPython SDKを使用して、MCPサーバーを実装します。これにより、クロード氏をはじめとする法学修士（LLM）は、演劇テキストコーパスとの対話、登場人物ネットワークの分析、演劇情報の取得、そして異なる言語や時代をまたぐ演劇作品に関する洞察の生成が可能になります。

このプロジェクトには 2 つの実装が含まれます。

dracor_mcp_fastmcp.py - v1 API を使用した FastMCP デコレータベースの API を使用した合理化された実装

特徴

統一されたインターフェースを介してDraCor API v1にアクセス
認証は不要です（DraCor APIは公開されています）
DraCorエンティティの構造化データモデル
運用サポート：
- コーパスと遊びの情報検索
- キャラクターネットワーク分析
- プレイの指標と統計
- キャラクター情報と音声テキスト
- 比較プレイ分析
- 検索機能
- キャラクター関係データ
- 複数の形式のネットワークデータ（CSV、GEXF、GraphML）
- 演劇におけるジェンダー分析
- プレーンテキストおよびTEI XML形式での全文検索
- 完全な劇中テキスト分析

設定

前提条件

Python 3.10以上
UV パッケージマネージャー (推奨) または pip

UVによる設置

UVをインストールします:

pip install uv

仮想環境を作成し、依存関係をインストールします。

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

Claude Desktop に MCP サーバーをインストールします。

標準実装の場合 (v0 API):

mcp install dracor_mcp_server.py

または、v1 API を使用した FastMCP 実装の場合 (推奨):

mcp install dracor_mcp_fastmcp.py

開発モード

テストと開発の場合:

mcp dev dracor_mcp_server.py

または、v1 API を使用した FastMCP 実装の場合 (推奨):

mcp dev dracor_mcp_fastmcp.py

これにより、MCP Inspector が起動し、ツールとリソースをインタラクティブにテストできるようになります。

クロード・コンフィグレーション

次のコードを Claude 構成ファイルに追加して、Claude が DraCor MCP サーバーを使用するように直接構成することもできます。

{
  "tools": {
    "DraCor API v1": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "requests",
        "--with",
        "pydantic",
        "--with",
        "python-multipart",
        "mcp",
        "run",
        "/path/to/dracor-mcp/dracor_mcp_fastmcp.py"
      ]
    }
  }
}

/path/to/dracor-mcp/ dracor-mcp ディレクトリへの実際のパスに置き換えてください。この設定では、事前のインストールを必要とせずに、 uv runを使用して必要な依存関係を持つ MCP サーバーを実行します。

Docker（オプション）

Docker を使用する場合:

docker build -t dracor-mcp .
docker run dracor-mcp

代わりに v1 API で FastMCP 実装を使用するには:

docker run -e IMPLEMENTATION=fastmcp dracor-mcp

実装の詳細

標準 MCP 実装 (v0 API)

dracor_mcp_server.pyの標準実装では、古い v0 API を使用したコア MCP SDK クラスが使用されます。

Resource - APIリソースを定義する
MCPToolImpl - ツールの実装用
PromptTemplate - プロンプトテンプレートを作成する

FastMCP 実装 (v1 API)

dracor_mcp_fastmcp.pyの FastMCP 実装では、現在の v1 API を使用した、より簡潔なデコレータベースのアプローチが使用されています。

@mcp.resource() - APIリソースを定義するため
@mcp.tool() - ツールを実装するため
@mcp.prompt() - プロンプトテンプレートを作成する

このアプローチにより、同じ機能を提供しながら、より包括的な API 機能にアクセスでき、よりクリーンで保守しやすいコードが実現します。

v1 API 機能

v1 API 実装では、多くの追加のエンドポイントと機能へのアクセスが提供されます。

API 情報- DraCor API のバージョン情報
コーパスメタデータ- コーパス内のすべての演劇の詳細なメタデータ
プレイメトリクス- ネットワークメトリクスと分析データ
文字ネットワークデータ- CSV、GEXF、GraphML 形式
キャラクター関係- キャラクター間の明確な関係
音声テキストフィルター- 性別、関係タイプ、キャラクターの役割でフィルターします
舞台指示- スピーカーの有無にかかわらず舞台指示を取得します
キャラクター検索- 特定のキャラクターが登場する演劇を検索（Wikidata ID で）

使用法

Claude Desktopにインストールすると、Claudeを介してDraCor APIを操作できるようになります。以下に例をいくつか示します。

基本的なクエリ

利用可能なコーパスをリストするように Claude に依頼します。

Can you list all available drama corpora in DraCor?

特定の演劇に関する情報を取得します。

Tell me about Goethe's Faust in the German corpus

文字ネットワークを分析します。

Analyze the character network in Hamlet from the Shakespeare corpus

高度なクエリ

登場人物の関係性を分析する:

What are the strongest character relationships in Pushkin's Boris Godunov?

演劇を比較する:

Compare Goethe's Faust and Schiller's Die Räuber in terms of network density and character count

文字の重要性を分析する:

Who are the most central characters in Shakespeare's Hamlet based on speaking time and relationships?

性別の表現を分析する:

Analyze the gender distribution and representation in Molière's Le Misanthrope

さまざまな演劇の登場人物を見つける:

Find all plays that feature a character named "Hamlet" or similar

劇の全文を分析します。

Provide a comprehensive analysis of the full text of Goethe's Faust

劇中のテキストからテーマを抽出します。

What are the main themes and motifs in the full text of Shakespeare's Hamlet?

言語パターンを分析する:

Analyze the language patterns and style in Chekhov's The Cherry Orchard

文学分析クエリ

プレイ構造を分析する:

Analyze the structure of Molière's Le Misanthrope in terms of acts, scenes, and dialogue distribution

著者を比較:

Compare the network structures in plays by Shakespeare and Molière

歴史的背景:

Put Pushkin's Boris Godunov in its historical context and analyze how this is reflected in the character network

リソース（v1 API）

FastMCP サーバーは次のリソースを公開します。

info:// - API情報とバージョンの詳細
corpora:// - 利用可能なすべてのコーパスのリスト
corpus://{corpus_name} - 特定のコーパスに関する情報
corpus_metadata://{corpus_name} - コーパス内のすべての演劇のメタデータ
plays://{corpus_name} - 特定のコーパス内の演劇のリスト
play://{corpus_name}/{play_name} - 特定の演劇に関する情報
play_metrics://{corpus_name}/{play_name} - 特定のプレイのネットワークメトリクス
characters://{corpus_name}/{play_name} - 特定の劇の登場人物のリスト
spoken_text://{corpus_name}/{play_name} - 劇中の音声テキスト（オプションのフィルター付き）
spoken_text_by_character://{corpus_name}/{play_name} - 各キャラクターが話すテキスト
stage_directions://{corpus_name}/{play_name} - 演劇の舞台指示
network_data://{corpus_name}/{play_name} - CSV形式のネットワークデータ
relations://{corpus_name}/{play_name} - CSV形式のキャラクター関係データ
character_by_wikidata://{wikidata_id} - ウィキデータ ID ごとに、キャラクターを含む演劇をリストします。
full_text://{corpus_name}/{play_name} - プレーンテキスト形式の演劇の全文
tei_text://{corpus_name}/{play_name} - 演劇の完全なTEI XMLテキスト

ツール（v1 API）

FastMCP サーバーは次のツールを提供します。

search_plays - クエリに基づいて演劇を検索する
compare_plays - 2つのプレイをメトリクスと構造の観点から比較します
analyze_character_relations - 劇中の登場人物の関係を分析する
analyze_play_structure - プレイの構造を分析する
find_character_across_plays - 複数のプレイにわたってキャラクターを見つける
analyze_full_text - 台詞や舞台指示を含む劇の全文を分析する

プロンプトテンプレート（v1 API）

FastMCP サーバーには次のプロンプトテンプレートが含まれています。

analyze_play - 特定のプレイを分析するためのテンプレート
character_analysis - 特定の文字を分析するためのテンプレート
network_analysis - 文字ネットワークを分析するためのテンプレート
comparative_analysis - 2つの演劇を比較するためのテンプレート
gender_analysis - 演劇におけるジェンダー表現を分析するためのテンプレート
historical_context - 演劇の歴史的背景を分析するためのテンプレート
full_text_analysis - 演劇の全文を分析するためのテンプレート

仕組み

このプロジェクトでは、公式のモデルコンテキストプロトコル Python SDK を使用して、Claude が DraCor API と対話するために使用できるリソースとツールを公開する MCP サーバーを構築します。

クロードに劇的なテキストについて質問すると、次のようになります。

コーパス、演劇、キャラクター、ネットワークなどのリソースにアクセスする
ツールを使用してプレイを検索、比較、分析する
データに基づいて洞察と視覚化を提供する

DraCor API はパブリックにアクセス可能なので、認証は必要ありません。

レート制限

DraCor のレート制限ポリシーにご注意ください。サーバーには、.env ファイルで設定できるオプションのレート制限設定が含まれています。

トラブルシューティング

問題が発生した場合:

Python 3.10以降を使用していることを確認してください
デバッグするには開発モードで実行してみてください: mcp dev dracor_mcp_fastmcp.py
DraCor API のステータスはhttps://dracor.org/doc/apiで確認できます。

MCP で使用するプロンプト

あなたの任務は、DraCorデータベースから過去の演劇を分析し、キャラクターIDのタグ付けの問題を特定することです。具体的には、

DraCor データベースから演劇を選択し、登場人物の関係、全文、構造を包括的に分析します。
次のような、キャラクター ID タグ付けにおけるすべての可能性のある不一致を特定します。
- キャラクター名の綴りのバリエーション
- キャラクター名の混同または混同
- 歴史的な綴りの変種
- キャラクターIDと舞台指示の不一致
次の列を含む構造化されたテーブル形式で、潜在的な文字 ID タグ付けエラーの詳細なレポートを作成します。
- テキストID（演劇の一意の識別子）
- データベースで使用されている現在の文字ID
- テキスト内に問題のある変種が見つかりました
- エラーの種類 (スペル、変形、混乱など)
- 問題の説明

このテキストに対して実行してください: [プレイ名]

ライセンス

マサチューセッツ工科大学

謝辞

このプロジェクトでは以下を使用します:

MCP サーバーを構築するためのモデルコンテキストプロトコル Python SDK
ドラマチックなテキストとネットワークデータのためのDraCor API v1
基礎データとAPIを提供するドラマコーポラプロジェクト（DraCor）

DraCor MCP Server

Integrations