PoetryDB MCP сервер

Неофициальный MCP-сервер для изучения классической поэзии через PoetryDB.

Краткая сводка

Related MCP server: ClaudeSkills MCP Server

Установка

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: запрос нескольких полей 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.

• Создан для MCP-клиентов, которые предпочитают компактный stdio-сервер вместо специальной интеграции с PoetryDB.

• Идентификатор в реестре MCP: io.github.lacausecrypto/poetrydb

Атрибуция

• PoetryDB: poetrydb.org

• Upstream project: thundercomb/poetrydb

Дополнительные примечания по реализации находятся в documentation.md.