# گنجور (نسخهٔ رسمی) (Ganjoor MCP Server)

سرور رسمی گنجور با ۴۴ قابلیت: شعر و شاعران، وزن و قافیه، فال حافظ، دکلمه‌ها، شخصیت‌ها و نسخه‌های خطی

- نوع: سرور MCP
- دسته: زبان و ادبیات فارسی
- منبع: رسمی
- سازنده: Ganjoor (https://github.com/ganjoor)
- مجوز: MIT
- زبان: TypeScript
- آخرین بررسی: 2026-10-16
- صفحه: https://mcpfarsi.ir/servers/ganjoor-official/
- مخزن: https://github.com/ganjoor/ganjoor-mcp-server
- وب‌سایت سرویس: https://ganjoor.net

## نصب

- اجرا (stdio): `npx -y ganjoor-mcp-server`

## ابزارها

- `ganjoor_list_poets`: فهرست همه شاعران گنجور با زندگی‌نامه
- `ganjoor_get_poet`: مشخصات کامل یک شاعر
- `ganjoor_get_poets_by_century`: شاعران به تفکیک دوره تاریخی
- `ganjoor_list_books`: فهرست کتاب‌ها و دیوان‌ها
- `ganjoor_get_category`: یک کتاب یا بخش از آن
- `ganjoor_list_category_poems`: شعرهای یک کتاب یا بخش
- `ganjoor_get_category_geotags`: مکان‌های جغرافیایی و تاریخی برچسب‌خورده در یک کتاب
- `ganjoor_get_category_people_graph`: شبکه شخصیت‌های تاریخی مرتبط با یک اثر
- `ganjoor_search_poems`: جستجوی متنی در همه شعرها
- `ganjoor_semantic_search_poems`: جستجوی معنایی، مثل «شعری درباره غربت»
- `ganjoor_get_poem`: متن کامل یک شعر با نشانی آن، همراه وزن، قافیه و دکلمه‌ها
- `ganjoor_get_poem_by_id`: متن کامل یک شعر با شناسه آن
- `ganjoor_get_poem_verses`: فقط بیت‌های یک شعر
- `ganjoor_get_random_poem`: یک شعر تصادفی، از همه یا یک شاعر
- `ganjoor_get_hafez_faal`: فال حافظ
- `ganjoor_get_page_url`: نشانی صفحه یک شعر، کتاب یا شاعر
- `ganjoor_get_redirect_url`: نشانی فعلی یک لینک قدیمی گنجور
- `ganjoor_list_rhythms`: فهرست وزن‌های عروضی
- `ganjoor_analyze_poem_rhythm`: تشخیص وزن یک شعر
- `ganjoor_analyze_poem_rhyme`: تشخیص قافیه یک شعر
- `ganjoor_find_similar_poems`: شعرهای هم‌وزن و هم‌قافیه
- `ganjoor_get_poem_sections`: بخش‌های ساختاری یک شعر (بند، مثنوی، رباعی)
- `ganjoor_get_section`: یک بخش از شعر با بیت‌هایش
- `ganjoor_get_related_sections`: بخش‌های هم‌وزن و هم‌قافیه از شعرهای دیگر
- `ganjoor_get_couplet_sections`: بخش‌هایی که یک بیت به آن‌ها تعلق دارد
- `ganjoor_get_language_tagged_sections`: بخش‌هایی که به زبانی خاص برچسب خورده‌اند
- `ganjoor_search_recitations`: جستجو در دکلمه‌های صوتی
- `ganjoor_get_recitation`: یک دکلمه با فایل صوتی آن
- `ganjoor_get_recitation_sync_info`: زمان شروع هر بیت در فایل دکلمه
- `ganjoor_get_poem_recitations`: همه دکلمه‌های یک شعر
- `ganjoor_get_category_top_recitations`: بهترین دکلمه‌های یک کتاب
- `ganjoor_list_people`: فهرست شخصیت‌های تاریخی و ادبی
- `ganjoor_get_person`: زندگی‌نامه و مشخصات یک شخصیت
- `ganjoor_get_person_poems`: شعرهای مرتبط با یک شخصیت
- `ganjoor_get_person_relations`: خویشاوندان، استادان و هم‌عصران یک شخصیت
- `ganjoor_get_person_family_tree`: شجره‌نامه یک شخصیت
- `ganjoor_get_recent_comments`: تازه‌ترین حاشیه‌های خوانندگان
- `ganjoor_list_faq_categories`: دسته‌های پرسش‌های متداول گنجور
- `ganjoor_get_faq_items`: پرسش‌ها و پاسخ‌های یک دسته
- `ganjoor_get_faq_item`: یک پرسش متداول
- `ganjoor_get_poem_images`: تصویر نسخه‌های خطی یک شعر
- `ganjoor_get_poem_quoted_poems`: شعرهایی که این شعر از آن‌ها نقل کرده یا از آن نقل کرده‌اند
- `ganjoor_get_poem_effective_corrections`: تصحیح‌های ویرایشی اعمال‌شده روی متن یک شعر
- `ganjoor_get_poem_geotags`: مکان‌های برچسب‌خورده در یک شعر

## نمونه سؤال‌ها

- یک فال حافظ بگیر و معنی‌اش را ساده بگو.
- وزن و قافیه غزل «الا یا ایها الساقی» را تشخیص بده و چند غزل هم‌وزن آن را بیاور.
- چه دکلمه‌هایی از این غزل سعدی در گنجور هست؟

## توضیحات

با این ابزار، دستیار هوش مصنوعی شما شعر فارسی را مستقیم از [گنجور](https://ganjoor.net) می‌خواند. این سرور را خود گنجور منتشر کرده و ۴۴ قابلیت دارد: از جستجو و خواندن شعر تا تشخیص وزن و قافیه، پیدا کردن شعرهای هم‌وزن، دکلمه‌های صوتی، فال حافظ، شخصیت‌های تاریخی و شجره‌نامه آن‌ها، تصویر نسخه‌های خطی و حاشیه‌های خوانندگان.

روی کامپیوتر شما اجرا می‌شود، فقط می‌خواند و کلید API لازم ندارد. برای اجرا Node.js نسخه ۱۸٫۱۷ یا جدیدتر لازم است.

تفاوت با «گنجور»: آن سرور ساده‌تر را همین بازارچه ساخته و فقط چهار قابلیت اصلی دارد (فهرست شاعران، جستجو، شعر تصادفی و خواندن شعر). اگر فقط شعر می‌خواهید آن کافی است؛ برای تحلیل وزن و قافیه، دکلمه‌ها و جزئیات بیشتر این نسخه رسمی را نصب کنید.

- جستجوی معنایی گاهی از سمت گنجور خاموش است؛ در این حالت با کلمه فارسی جستجو کنید.