judian-poetry-mcp 1.0.5

Local Stdio MCP server for Judian poetry OpenAPI.

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 客户端配置里不保存聚典密钥。
• 不调用赏析接口，因为该接口当前返回加密文本。

快速安装

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 客户端

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	获取诗人详情

自检

& "$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。