PoetryDB MCP Server

PoetryDB MCP 服务

用于通过 PoetryDB 探索经典诗歌的非官方 MCP 服务。

概览

指标	值
工具	12
类别	3
传输方式	stdio
身份验证	无
MCP Registry 名称	io.github.lacausecrypto/poetrydb
npm 包	mcp-poetry
源 API	https://poetrydb.org
内容	按作者、标题、诗句文本和体裁查找经典诗歌

安装

npm install -g mcp-poetry

或从源码安装：

npm install
npm run build

MCP Registry

此服务已发布到 MCP Registry，名称为：

io.github.lacausecrypto/poetrydb

Claude Desktop

{
  "mcpServers": {
    "poetrydb": {
      "command": "npx",
      "args": ["-y", "mcp-poetry"]
    }
  }
}

对于本地检出，请将命令替换为：

{
  "mcpServers": {
    "poetrydb": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-poetrydb/dist/index.js"]
    }
  }
}

工具

目录

• catalog_overview：列出类别和可用工具
• catalog_category：显示特定类别的工具

搜索

• search_by_author：按作者姓名查找诗歌
• search_by_title：按标题查找诗歌
• search_by_lines：搜索诗句中的文本
• search_by_linecount：按确切行数查找诗歌
• search_combined：在一次请求中查询多个 PoetryDB 字段
• list_authors：列出所有可用作者

发现

• random_poem：获取一首或多首随机诗歌
• get_sonnets：获取 14 行诗歌
• get_haikus：获取 3 行俳句
• list_titles：列出诗歌标题

请求示例

简单请求

Random poem please.

预期工具：

random_poem({ "count": 1 })

浏览

Show me the available poets.

预期工具：

list_authors({})

定向搜索

Find Ozymandias.

预期工具：

search_by_title({ "title": "Ozymandias" })

文本搜索

Show me poems containing the word "love".

预期工具：

search_by_lines({ "text": "love" })

按体裁发现

Give me 14-line poems by Shakespeare.

预期工具：

search_combined({ "fields": "author,linecount", "values": "Shakespeare;14" })

进阶示例

List Shakespeare results, but only return title and linecount.

预期工具：

search_by_author({ "author": "Shakespeare", "fields": "title,linecount" })

多步探索

Start with the catalog, then show me the discovery tools, then give me a sonnet.

典型工具调用顺序：

catalog_overview({})
catalog_category({ "category_id": "discovery" })
get_sonnets({})

开发

npm run build
npm run test:ci
npm test
npm pack --dry-run

环境变量：

• POETRYDB_BASE_URL
• POETRYDB_REQUEST_TIMEOUT_MS
• POETRYDB_REQUEST_RETRIES

备注

• 无需 API 密钥。
• 此包与 PoetryDB 无关。
• 为偏好精简 stdio 服务而非自定义 PoetryDB 集成的 MCP 客户端打造。
• MCP Registry 标识：io.github.lacausecrypto/poetrydb

致谢

• PoetryDB：poetrydb.org
• 上游项目：thundercomb/poetrydb

更多实现说明请参阅 documentation.md。