PoetryDB MCP Server

Servidor MCP no oficial para explorar poesía clásica a través de PoetryDB.

De un vistazo

Related MCP server: ClaudeSkills MCP Server

Instalación

npm install -g mcp-poetry

O desde el código fuente:

npm install
npm run build

Registro MCP

Este servidor está publicado en el Registro MCP bajo:

io.github.lacausecrypto/poetrydb

Claude Desktop

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

Para una copia local, reemplace el comando por:

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

Herramientas

Catálogo

• catalog_overview: lista las categorías y las herramientas disponibles

• catalog_category: muestra las herramientas de una categoría específica

Búsqueda

• search_by_author: encuentra poemas por nombre de autor

• search_by_title: encuentra un poema por título

• search_by_lines: busca texto dentro de las líneas del poema

• search_by_linecount: encuentra poemas por número exacto de líneas

• search_combined: consulta múltiples campos de PoetryDB en una sola solicitud

• list_authors: lista todos los autores disponibles

Descubrimiento

• random_poem: obtiene uno o más poemas aleatorios

• get_sonnets: obtiene poemas de 14 líneas

• get_haikus: obtiene poemas de 3 líneas

• list_titles: lista los títulos de los poemas

Ejemplos de solicitudes

Sencillo

Random poem please.

Herramienta esperada:

random_poem({ "count": 1 })

Explorar

Show me the available poets.

Herramienta esperada:

list_authors({})

Búsqueda específica

Find Ozymandias.

Herramienta esperada:

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

Búsqueda de texto

Show me poems containing the word "love".

Herramienta esperada:

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

Descubrimiento por forma

Give me 14-line poems by Shakespeare.

Herramienta esperada:

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

Más avanzado

List Shakespeare results, but only return title and linecount.

Herramienta esperada:

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

Exploración en varios pasos

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

Secuencia típica de herramientas:

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

Desarrollo

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

Variables de entorno:

• POETRYDB_BASE_URL

• POETRYDB_REQUEST_TIMEOUT_MS

• POETRYDB_REQUEST_RETRIES

Notas

• No se requiere clave de API.

• Este paquete no está afiliado con PoetryDB.

• Diseñado para clientes MCP que prefieren un servidor stdio compacto en lugar de una integración personalizada de PoetryDB.

• Identidad en el Registro MCP: io.github.lacausecrypto/poetrydb

Atribución

• PoetryDB: poetrydb.org

• Proyecto upstream: thundercomb/poetrydb

Notas adicionales de implementación se encuentran en documentation.md.