Metadata-Version: 2.4
Name: dhcckb-poet-network-mcp
Version: 0.1.0
Summary: 诗人关系网络 MCP 工具 — 查询古典文献知识图谱中的诗人交游数据，输出结构化 CSV
Project-URL: Homepage, https://cnkgraph.com/
Author: DHCCKB
License: MIT
Keywords: chinese-poetry,cnkgraph,mcp,network,poet
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
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
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.0.0
Description-Content-Type: text/markdown

# 诗人关系网络 MCP 工具 (dhcckb-poet-network-mcp)

基于 [CNK Graph 古典文献知识图谱](https://cnkgraph.com/) 开放 API 构建的 MCP Server，
让 LLM 客户端可通过标准 MCP 协议查询诗人交游关系网络，并以结构化 CSV 文本输出结果。

## 安装

```bash
uvx dhcckb-poet-network-mcp
# 或
pip install dhcckb-poet-network-mcp
```

## MCP 客户端配置

在 Claude Desktop、Cursor 等 MCP 宿主中添加：

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

## 工具列表

### query_poet_relationships

查询诗人交游关系网络。输入 Author 和/或 Friend，返回含作者、交游对象、作品题目、作品正文、创作时间、创作地址的 CSV 文本，
并同时写入本地 `.csv` 文件。

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| author | string | 否* | 作者姓名，如 李白、杜甫 |
| friend | string | 否* | 交游对象姓名 |
| begin_year | integer | 否 | 起始年份（公元纪年） |
| end_year | integer | 否 | 截止年份（公元纪年） |
| scope | string | 否 | 查询范围限定 |
| begin_place | string | 否 | 起始地点 |
| end_place | string | 否 | 截止地点 |
| marked_poem_ids | string | 否 | 指定诗作 ID，逗号分隔 |
| labels | string | 否 | 标签筛选 |
| details_in_raw | boolean | 否 | 是否返回原始详情 |
| dynasty | string | 否 | 朝代筛选，如 唐、宋 |

> *author 与 friend 至少填写一个。
