Metadata-Version: 2.4
Name: judian-poetry-mcp
Version: 1.0.5
Summary: Local Stdio MCP server for Judian poetry OpenAPI.
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.0.0
Requires-Dist: httpx[http2]>=0.27.0
Requires-Dist: keyring>=25.0.0

# judian-poetry-mcp

聚典诗文数据库本地 Stdio MCP 服务，适用于 Kimi Code CLI、Claude Code、Claude Desktop、Codex CLI、Trae、Cursor、Windsurf、Cline 等 MCP 客户端。

当前版本：`1.0.5`

## 简介

本 MCP 将聚典诗文 OpenAPI 封装为本地工具。所有 HTTPS 请求都从用户本机发出，用于满足聚典授权阶段的 IP 白名单校验要求。

安全设计：

- `clientSecret` 保存到系统钥匙串。
- MCP 客户端配置里不保存聚典密钥。
- 不调用赏析接口，因为该接口当前返回加密文本。

## 快速安装

```powershell
python -m venv "$env:USERPROFILE\.judian-mcp"
& "$env:USERPROFILE\.judian-mcp\Scripts\python.exe" -m pip install --upgrade pip
& "$env:USERPROFILE\.judian-mcp\Scripts\python.exe" -m pip install judian-poetry-mcp
& "$env:USERPROFILE\.judian-mcp\Scripts\python.exe" -m judian_mcp_server setup
```

## 常用 MCP 客户端

```powershell
kimi mcp add --transport stdio judian-poetry-db -- "$env:USERPROFILE\.judian-mcp\Scripts\python.exe" -m judian_mcp_server
kimi mcp test judian-poetry-db

claude mcp add --transport stdio --scope user judian-poetry-db -- "$env:USERPROFILE\.judian-mcp\Scripts\python.exe" -m judian_mcp_server
claude mcp get judian-poetry-db
```

Trae、Cursor、Windsurf、Cline 等支持 `mcpServers` JSON 的客户端，可使用 `用户安装说明.md` 中的通用 stdio 配置。

## 工具列表

| 工具 | 用途 |
| --- | --- |
| `search_poetry` | 搜索诗文 |
| `get_poetry_details` | 获取诗文详情、正文、注释 |
| `get_poetry_translation` | 获取译文 |
| `get_poetry_tags` | 获取标签 |
| `search_poetry_authors` | 搜索诗人 |
| `get_poetry_author_details` | 获取诗人详情 |

## 自检

```powershell
& "$env:USERPROFILE\.judian-mcp\Scripts\python.exe" -m judian_mcp_server doctor
& "$env:USERPROFILE\.judian-mcp\Scripts\python.exe" -m judian_mcp_server config-path
```

完整安装、凭证配置和常用 MCP 客户端配置方法见 `用户安装说明.md`，发布流程见 `发布说明.md`。
