Metadata-Version: 2.4
Name: dhcckb-mcp-ctext
Version: 0.2.0
Summary: ctext.org 古典文献检索与研究整理 MCP 工具 - 面向数字人文研究的中国哲学书电子化计划公开文献检索、关键词定位、文本获取与结果导出
Project-URL: Homepage, https://pypi.org/project/dhcckb-mcp-ctext/
Project-URL: Documentation, https://ctext.org/tools/api
Author: Digital Humanities Platform
License: MIT
Keywords: chinese-text,classical-literature,ctext,digital-humanities,mcp,text-retrieval
Classifier: Development Status :: 3 - Alpha
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: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Text Processing
Requires-Python: >=3.10
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# mcp-ctext

ctext.org 古典文献检索与研究整理 MCP 工具 — 面向数字人文研究的中国哲学书电子化计划（ctext.org）公开文献检索、关键词定位、文本获取与结果导出。

## 功能概述

本 MCP Server 提供 6 个标准化工具，服务于古典文献学、古典文学和数字人文研究：

| 工具 | 功能 |
|------|------|
| `search_work` | 文献查询 — 检索 ctext.org 中的相关文献条目 |
| `get_work_metadata` | 获取文献元数据与章节目录结构 |
| `search_keyword_in_work` | 文献内关键词全文检索（精确/正则/模糊） |
| `get_chapter_text` | 获取指定章节的公开文本内容 |
| `export_results` | 检索结果多格式导出（JSON/CSV/TXT/Markdown） |
| `get_work_full_text` | 获取一部文献的全部公开文本内容 |

## 安装

需要 Python ≥ 3.10。

```bash
pip install dhcckb-mcp-ctext
```

## 配置 Claude Desktop

在 Claude Desktop 配置文件中添加：

```json
{
  "mcpServers": {
    "mcp-ctext": {
      "command": "uvx",
      "args": ["dhcckb-mcp-ctext"]
    }
  }
}
```

## 核心设计原则

1. **合法合规**：仅访问 ctext.org 公开页面和文本；请求间隔 ≥ 2 秒
2. **研究友好**：输出含书名、篇章、章节、URL 等完整引用信息
3. **可复核**：所有结果保留来源链接
4. **可导出**：支持 JSON/CSV/TXT/Markdown 四种格式
5. **容错设计**：无 OCR 文本或仅有扫描件时返回提示而非中断

## 环境变量

| 变量 | 默认值 | 说明 |
|------|--------|------|
| `CTEXT_EXPORT_DIR` | 当前工作目录 | 导出文件默认目录 |
| `CTEXT_FULL_TEXT_INTERVAL` | `3.0` | 全量获取时的章节间请求间隔（秒） |

## 许可

MIT License
