Metadata-Version: 2.4
Name: dhcckb-mcp-server-imagery
Version: 1.0.0
Summary: MCP Server for Chinese literary imagery analysis — tokenization, imagery extraction, frequency statistics, and cross-corpus comparison for digital humanities research.
Author: Digital Humanities Platform
License-Expression: MIT
Keywords: chinese-poetry,digital-humanities,imagery,jieba,mcp,nlp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Text Processing :: Linguistic
Requires-Python: >=3.10
Requires-Dist: jieba>=0.42
Requires-Dist: mcp>=1.0.0
Provides-Extra: analysis
Requires-Dist: pandas>=2.0; extra == 'analysis'
Description-Content-Type: text/markdown

# mcp-server-imagery

面向数字人文研究的 MCP Server，提供中文文学文本的意象词自动提取与统计分析能力。

## 功能

- **tokenize**: 中文分词与词性标注（古典诗词/白话双模式）
- **extract_imagery**: 意象词双层提取（核心意象词 + 完整意象词）
- **analyze_corpus**: 批量语料分析（频率、丰富度、共现矩阵）
- **compare_corpora**: 两个语料库意象对比分析
- **export_results**: 结果导出（JSON/CSV/Markdown）

## 安装

```bash
pip install dhcckb-mcp-server-imagery
```

## 使用

### 作为 MCP Server

在 Claude Code 或其他 MCP 客户端配置中：

```json
{
  "mcpServers": {
    "imagery": {
      "command": "mcp-server-imagery"
    }
  }
}
```

### 命令行

```bash
mcp-server-imagery
# 或
python -m mcp_server_imagery
```

## 意象词典

内置 ~700 词条的唐宋诗词常见意象词典，分为：
- **通用意象**（跨文体）：自然景物、季节时令、建筑器物等
- **领域意象**（红楼梦专用）：如「通灵玉」「绛珠草」「太虚幻境」等

支持通过 `customDict` 参数在运行时加载自定词典。

## 许可

MIT
