PoetryDB MCP Server

PoetryDB MCP サーバー

PoetryDB を通じて古典詩を探索するための非公式 MCP サーバーです。

概要

指標	値
ツール	12
カテゴリ	3
トランスポート	stdio
認証	なし
MCP レジストリ名	io.github.lacausecrypto/poetrydb
npm パッケージ	mcp-poetry
ソース API	https://poetrydb.org
コンテンツ	作者、タイトル、詩行のテキスト、形式から探す古典詩

インストール

npm install -g mcp-poetry

または、ソースからインストールします：

npm install
npm run build

MCP レジストリ

このサーバーは、以下の名前で MCP レジストリに公開されています：

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：1 回のリクエストで PoetryDB の複数のフィールドを検索します
• list_authors：利用可能な作者をすべて一覧表示します

発見

• random_poem：ランダムな詩を 1 編以上取得します
• 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 とは提携していません。
• カスタムの PoetryDB 統合よりも、コンパクトな stdio サーバーを好む MCP クライアント向けに作られています。
• MCP レジストリの識別子：io.github.lacausecrypto/poetrydb

帰属表示

• PoetryDB：poetrydb.org
• 上流プロジェクト：thundercomb/poetrydb

実装に関する補足はdocumentation.mdに記載されています。