DraCor MCP Server

DraCor MCP Server

site icon
2025.03.26 2
Python戏剧文本分析角色网络研究文学研究内容生成
DraCor MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,用于与 Drama Corpora Project (DraCor) API 进行交互。该服务使 Claude 或其他大型语言模型能够无缝分析戏剧文本及其角色网络。
View on GitHub

Overview

基本能力

产品定位

DraCor MCP Server 是一个专门用于戏剧文本分析的 MCP 服务器,提供对 DraCor API 的访问,支持对戏剧文本、角色网络和剧本结构的深入分析。

核心功能

  • 访问 DraCor API v1 的统一接口
  • 无需认证(DraCor API 公开可访问)
  • 结构化数据模型
  • 支持多种操作:
  • 剧本和剧本信息检索
  • 角色网络分析
  • 剧本指标和统计
  • 角色信息和台词文本
  • 剧本比较分析
  • 搜索功能
  • 角色关系数据
  • 多种格式的网络数据(CSV, GEXF, GraphML)
  • 性别分析
  • 完整文本检索(纯文本和 TEI XML 格式)
  • 完整剧本文本分析

适用场景

  • 戏剧文本分析
  • 角色网络研究
  • 剧本比较研究
  • 性别分析研究
  • 历史背景分析
  • 文学研究

工具列表

  • search_plays: 基于查询搜索剧本
  • compare_plays: 比较两个剧本的指标和结构
  • analyze_character_relations: 分析剧本中的角色关系
  • analyze_play_structure: 分析剧本结构
  • find_character_across_plays: 在多个剧本中查找角色
  • analyze_full_text: 分析剧本的完整文本

常见问题解答

  • 确保使用 Python 3.10 或更高版本
  • 尝试在开发模式下运行以调试
  • 检查 DraCor API 状态

使用教程

使用依赖

  • Python 3.10 或更高版本
  • UV 包管理器(推荐)或 pip

安装教程

  1. 安装 UV:
pip install uv
  1. 创建虚拟环境并安装依赖:
uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
uv pip install -e .
  1. 安装 MCP 服务器:
mcp install dracor_mcp_fastmcp.py

调试方式

在开发模式下运行:

mcp dev dracor_mcp_fastmcp.py

标签信息

安装类型

sse

产品定位

  • 戏剧文本分析
  • 角色网络研究
  • 文学研究

归类

内容生成

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。