PoetryDB MCP Server

Inoffizieller MCP-Server zum Erkunden klassischer Poesie über PoetryDB.

Auf einen Blick

Related MCP server: ClaudeSkills MCP Server

Installation

npm install -g mcp-poetry

Oder aus dem Quellcode:

npm install
npm run build

MCP-Registry

Dieser Server ist in der MCP-Registry unter folgendem Namen veröffentlicht:

io.github.lacausecrypto/poetrydb

Claude Desktop

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

Für ein lokales Checkout ersetzen Sie den Befehl durch:

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

Werkzeuge

Katalog

• catalog_overview: listet Kategorien und verfügbare Werkzeuge auf

• catalog_category: zeigt Werkzeuge für eine bestimmte Kategorie an

Suche

• search_by_author: findet Gedichte nach Autorenname

• search_by_title: findet ein Gedicht nach Titel

• search_by_lines: durchsucht Text in Gedichtzeilen

• search_by_linecount: findet Gedichte mit exakter Zeilenanzahl

• search_combined: fragt mehrere PoetryDB-Felder in einer Anfrage ab

• list_authors: listet alle verfügbaren Autoren auf

Entdeckung

• random_poem: ruft ein oder mehrere zufällige Gedichte ab

• get_sonnets: ruft Gedichte mit 14 Zeilen ab

• get_haikus: ruft Gedichte mit 3 Zeilen ab

• list_titles: listet Gedichtstitel auf

Beispielanfragen

Einfach

Random poem please.

Erwartetes Werkzeug:

random_poem({ "count": 1 })

Durchsuchen

Show me the available poets.

Erwartetes Werkzeug:

list_authors({})

Gezielte Suche

Find Ozymandias.

Erwartetes Werkzeug:

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

Textsuche

Show me poems containing the word "love".

Erwartetes Werkzeug:

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

Formbasierte Entdeckung

Give me 14-line poems by Shakespeare.

Erwartetes Werkzeug:

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

Fortgeschrittener

List Shakespeare results, but only return title and linecount.

Erwartetes Werkzeug:

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

Mehrstufige Erkundung

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

Typische Werkzeugsequenz:

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

Entwicklung

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

Umgebungsvariablen:

• POETRYDB_BASE_URL

• POETRYDB_REQUEST_TIMEOUT_MS

• POETRYDB_REQUEST_RETRIES

Hinweise

• Es ist kein API-Schlüssel erforderlich.

• Dieses Paket ist nicht mit PoetryDB verbunden.

• Entwickelt für MCP-Clients, die einen kompakten stdio-Server einer benutzerdefinierten PoetryDB-Integration vorziehen.

• MCP-Registry-Identität: io.github.lacausecrypto/poetrydb

Namensnennung

• PoetryDB: poetrydb.org

• Upstream-Projekt: thundercomb/poetrydb

Weitere Implementierungshinweise finden Sie in documentation.md.