Metadata-Version: 2.4
Name: dhcckb-dhcn-paper-search
Version: 0.1.1
Summary: MCP Server for searching digital humanities papers on DHCN (dhcn.cn/cnpaper)
License: MIT
Requires-Python: >=3.10
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp<2.0.0,>=1.0.0
Description-Content-Type: text/markdown

# dhcckb-dhcn-paper-search

MCP Server for searching digital humanities papers on DHCN (https://www.dhcn.cn/cnpaper).

## Tools

### search_papers
查询数字人文相关论文。接受关键词、作者、年份等过滤参数，返回匹配的论文列表（标题、作者、摘要、链接等）。

Parameters:
- `keyword` (string, required): 搜索关键词
- `author` (string, optional): 按作者过滤
- `year` (integer, optional): 按年份过滤

### get_paper_detail
获取指定论文的详细信息。接受论文 ID（DHCN 详情页 URL），返回完整元数据：标题、作者列表、摘要、关键词、发表年份、DOI/链接等。

Parameters:
- `paper_id` (string, required): 论文唯一标识符（DHCN 详情页 URL）

### browse_by_topic
按主题浏览或推荐数字人文领域论文。可选传入 topic 标签限定范围，返回推荐论文列表。

Parameters:
- `topic` (string, optional): 数字人文子领域标签，如 text-mining, gis, network-analysis。不传则默认搜索"数字人文"

## Usage

Install via uvx:
```bash
uvx dhcckb-dhcn-paper-search
```

Or locally:
```bash
uv run dhcckb-dhcn-paper-search
# or
python -m dhcckb_dhcn_paper_search
```

## Cherry Studio Configuration

```json
{
  "mcpServers": {
    "dhcn-paper-search": {
      "command": "uvx",
      "args": ["dhcckb-dhcn-paper-search"]
    }
  }
}
```

> **Note:** The package declares `mcp>=1.0.0,<2.0.0` in its own `pyproject.toml`. No need to specify `--with mcp==1.13.1` manually.

## Dependencies

- Python >= 3.10
- httpx >= 0.27.0
- beautifulsoup4 >= 4.12.0
- mcp >= 1.0.0, < 2.0.0

## Changelog

### v0.1.1
- Fix: migrate from deprecated `MCPServer` to official `FastMCP` API
- Add: `search_papers` tool with keyword/author/year filtering
- Add: `browse_by_topic` tool for topic-based browsing
- Update: `get_paper_detail` uses `paper_id` parameter
- Lock `mcp` dependency to `>=1.0.0,<2.0.0` for API stability
