# گنجور (Ganjoor)

جستجو و خواندن شعر شاعران پارسی‌گو از گنجور؛ حافظ، سعدی، مولانا، فردوسی و صدها شاعر دیگر

- نوع: سرور MCP
- دسته: زبان و ادبیات فارسی
- منبع: ساختهٔ بازارچه
- سازنده: بازارچه MCP
- مجوز: MIT
- زبان: JavaScript
- آخرین بررسی: 2026-10-29
- صفحه: https://mcpfarsi.ir/servers/ganjoor/
- وب‌سایت سرویس: https://ganjoor.net

## نصب

- بسته npm هنوز منتشر نشده؛ فعلاً از راه روتر MCP استفاده کنید.
- بدون نصب: از راه روتر MCP (https://mcp.mcpfarsi.ir/mcp، ورود با OAuth)؛ راهنما: https://mcpfarsi.ir/start/

## API گنجور

- REST API روتر MCP همین ابزار را برای اسکریپت و برنامه هم اجرا می‌کند: `GET https://mcpfarsi.ir/api/v1/tools?q=` قابلیت‌ها و آرگومان‌هایشان را برمی‌گرداند و `POST https://mcpfarsi.ir/api/v1/call` یکی را اجرا می‌کند. شناسهٔ سرور: `ganjoor`.
- اول ابزار را در داشبورد به ابزارهای خودتان اضافه کنید، بعد کلید API را در https://mcpfarsi.ir/dashboard/?tab=access بسازید و با `Authorization: Bearer <کلید>` بفرستید. هر اجرای موفق از سقف طرح کم می‌شود (https://mcpfarsi.ir/pricing/).

```sh
curl "https://mcpfarsi.ir/api/v1/tools?q=ganjoor&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST "https://mcpfarsi.ir/api/v1/call" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"server": "ganjoor", "tool": "list_poets", "arguments": {}}'
```

## ابزارها

- `list_poets`: فهرست شاعران گنجور با شناسه هر کدام
- `search_verses`: جستجوی یک کلمه یا مصرع در شعرها، در شعر همه شاعران یا یک شاعر
- `random_poem`: یک شعر تصادفی، از همه شاعران یا یک شاعر خاص
- `get_poem`: متن کامل یک شعر با شناسه آن

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

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

## توضیحات

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

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

#### نکته‌ها

- کلید API لازم نیست.
- در روتر MCP هست و بدون نصب در دسترس است.
- لطفاً در کارتان از گنجور نام ببرید؛ این پروژه را داوطلبان نگه می‌دارند.
