sepehr071/iran-mcp

ganjoor

Read-only Ganjoor (ganjoor.net) Persian poetry: poems with meanings, search, meters, audio.

Ver código fuente

Cómo usar

  1. Copia el comando y revisa el paquete antes de instalarlo en tu entorno de agente.
  2. Consulta las herramientas, credenciales y entornos necesarios en el documento original.
  3. Describe las entradas y el resultado deseado; contrasta la salida con las fuentes.
npx skills add https://github.com/sepehr071/iran-mcp --skill ganjoor

Antes de empezar

  • La instalación no incluye suscripción al modelo, cuota API ni permisos sobre tus archivos.
  • Las estrellas e instalaciones reflejan actividad, no una prueba independiente de calidad o seguridad.
Documento original del Skill

Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.

Ganjoor Poetry

Read-only Ganjoor (ganjoor.net) Persian poetry: poems with meanings, search, meters, audio.

The tools below come from the ganjoor-mcp MCP server. If they are not available, install it with claude mcp add ganjoor -- uvx ganjoor-mcp, or add "ganjoor": {"command": "uvx", "args": ["ganjoor-mcp"]} to the client's MCP servers config. It needs uv. Restart the session after installing.

Tools

  • gj_meters: List poetic meters (وزن) with couplet counts, biggest first; filter by name.
  • gj_similar: Find poems that share a meter and rhyme, with their first couplet; 10 per page.
  • gj_recitations: List poem recitations (خوانش) with reciter, mp3 link, size and votes; give exactly one of poemid, catid, latest.
  • gj_literary: Show rhetorical devices (آرایه: tashbih, esteare...) and concepts tagged in poems; coverage is partial, mostly Hafez.
  • gj_words: Count word use in a poet's or book's poems: the most frequent words, or how often one word appears.
  • gj_people: Look up people and characters of epic poems (Shahnameh...): search, relations, family tree, or a book's cast.
  • gj_places: Find geotagged places (locations with latitude and longitude) named in poems, a book, or by name.
  • gj_museum: Browse Ganjoor museum manuscripts and scans (گنجینه): search, one manuscript's details, or one page image.
  • gj_search: Full-text search of poems by the words they contain, with the matching couplet.
  • gj_semantic_search: Find poems by meaning or theme (embedding search), with score, summary and first couplets.
  • gj_find_verse: Locate which poem and couplet a quoted line comes from, with the couplet's meaning.
  • gj_poem: Read a poem: text by couplet with meanings, summary, meter, rhyme, source and previous/next poem.
  • gj_poem_extras: Recitations with mp3 links, manuscript images, songs, related poems, quoting poems and reader comments.
  • gj_faal: Draw a Hafez faal (a random ghazal of Hafez) or, with random=True, a random poem, read with meanings.
  • gj_poets: List poets with ids, nicknames, life years (Hijri) and birthplace, filtered by name or century.
  • gj_poet: A poet's biography (shortened) and the top-level books to open with gj_book.
  • gj_book: Sub-books and the poems of one book or section, each with its first couplet, paged by 30.
  • gj_tajik: Search or read poems in Tajik Cyrillic transliteration (titles Cyrillic, poet names Persian).

Rules

  • Prices are Toman. Convert before comparing with a Rial figure from anywhere else.
  • Read-only: no login, basket, booking, order or payment. Give the user the link to finish on the site.
  • Keep request rates low. These are undocumented site APIs that can change or rate-limit.
  • On timeouts or HTTP 403 outside Iran, set GANJOOR_MCP_PROXY to an HTTP proxy with an Iranian IP.
  • Site: ganjoor.net. A couplet meaning that starts with «هوش مصنوعی:» is AI-written: say so when you quote it.

Maintainer

<a href="https://www.linkedin.com/in/sepehr-radmard"><img src="https://raw.githubusercontent.com/sepehr071/iran-mcp/main/assets/author-banner.png" alt="Sepehr Radmard: open-source MCP servers for the Iranian web" width="100%"></a>

Built and maintained by Sepehr Radmard (سپهر رادمرد): LinkedIn · GitHub. More servers for Iranian websites: iran-mcp.

del mismo repositorio

Más Skills

Todos los Skills