Metadata-Version: 2.4
Name: dhcckb-chinese-lit-ner
Version: 0.1.0
Summary: 中国古典文学命名实体识别 MCP Server - 支持13种实体类型、人工审核、模型适配层、外部资源集成与多格式导出
Author: Digital Humanities Platform
License: MIT
Keywords: chinese-classical-literature,digital-humanities,mcp-server,named-entity-recognition,ner
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: aiofiles>=23.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Provides-Extra: huggingface
Requires-Dist: torch>=2.0.0; extra == 'huggingface'
Requires-Dist: transformers>=4.40.0; extra == 'huggingface'
Description-Content-Type: text/markdown

# dhcckb-chinese-lit-ner

中国古典文学命名实体识别 MCP Server。

支持 13 种实体类型识别、人工审核工作流、模型适配层（OpenAI/Ollama/HuggingFace）、4 项外部资源集成（Wikidata/汉典/CHisIEC/Chinese-Literature-NER-RE-Dataset）、多格式导出和完整错误降级策略。

## 安装

```bash
pip install dhcckb-chinese-lit-ner
```

或使用 uvx 直接运行：

```bash
uvx dhcckb-chinese-lit-ner
```

## 配置

通过环境变量配置模型适配层：

| 环境变量 | 说明 | 可选值 |
|---------|------|--------|
| `MODEL_PROVIDER` | 模型提供方 | `openai`, `ollama`, `huggingface` |
| `MODEL_ENDPOINT` | 模型服务端点 | 如 `https://api.openai.com/v1` |
| `MODEL_NAME` | 模型名称 | 如 `gpt-4o` |
| `MODEL_API_KEY` | API 密钥 | 仅 OpenAI 模式需要 |
| `ENABLE_FALLBACK` | 启用降级模式 | `true`/`false` |
| `DB_PATH` | SQLite 数据库路径 | 默认 `./chinese_lit_ner.db` |

## 支持的实体类型

| Key | 中文名称 |
|-----|---------|
| PERSON | 人物 |
| LOCATION | 地点 |
| ORGANIZATION | 组织 |
| OFFICE_TITLE | 官职、爵位、身份 |
| BOOK | 书名、典籍 |
| LITERARY_WORK | 文学作品 |
| TEXT_SECTION | 卷、篇、章、传、本纪等 |
| TIME | 朝代、年号、日期、节令 |
| EVENT | 历史事件 |
| OBJECT | 器物 |
| BIOLOGICAL_ENTITY | 动植物、药材 |
| ABSTRACT_CONCEPT | 制度、思想、品德、情感 |
| MEASURE | 数量和度量单位 |

## MCP 客户端配置

```json
{
  "mcpServers": {
    "chinese-lit-ner": {
      "command": "uvx",
      "args": ["dhcckb-chinese-lit-ner"],
      "env": {
        "MODEL_PROVIDER": "openai",
        "MODEL_ENDPOINT": "https://api.openai.com/v1",
        "MODEL_NAME": "gpt-4o",
        "MODEL_API_KEY": "<your-api-key>"
      }
    }
  }
}
```

## 许可证

MIT
