Metadata-Version: 2.4
Name: dhcckb-mcp-server-imagery
Version: 1.1.1
Summary: MCP Server for Chinese literary imagery analysis — tokenization with layered dictionaries, imagery extraction with classification, cross-corpus comparison with statistical tests, and academic chart export 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<2,>=1.28
Provides-Extra: analysis
Requires-Dist: pandas>=2.0; extra == 'analysis'
Provides-Extra: charts
Requires-Dist: matplotlib>=3.7; extra == 'charts'
Requires-Dist: pillow>=9.0; extra == 'charts'
Requires-Dist: seaborn>=0.12; extra == 'charts'
Provides-Extra: stats
Requires-Dist: numpy>=1.24; extra == 'stats'
Requires-Dist: scipy>=1.10; extra == 'stats'
Description-Content-Type: text/markdown

# mcp-server-imagery

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

## 功能

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

## 依赖

- Python >= 3.10
- mcp >= 1.28, < 2（锁定 MCP Python SDK v1.x，兼容 @app.list_tools() / @app.call_tool() 风格）

## 安装

```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
