# بله (Bale MCP)

دستیارتان پیام‌های بازوی (ربات) بله را می‌خواند و جستجو می‌کند، پیام و فایل می‌فرستد و می‌تواند در گفتگو از شما سؤال بپرسد و منتظر جواب بماند

- نوع: سرور MCP
- دسته: پیامک و پیام‌رسان
- منبع: ساختهٔ بازارچه
- سازنده: sepehr071 (https://github.com/sepehr071)
- مجوز: MIT
- زبان: Python
- آخرین بررسی: 2026-11-07
- صفحه: https://mcpfarsi.ir/servers/bale/
- مخزن: https://github.com/sepehr071/bale-mcp
- وب‌سایت سرویس: https://bale.ai

## هشدارها

- نیازمند کلید API: برای کار کردن، کلید حساب خودتان در این سرویس لازم است.
- تغییر در حساب شما: بعضی ابزارهایش کاری انجام می‌دهند (مثلاً پیام می‌فرستند)، نه فقط خواندن.

## نصب

- اجرا (stdio): `uvx bale-mcp`
- متغیر محیطی `BALE_BOT_TOKEN` (لازم، محرمانه): توکن بازو؛ آن را از @botfather در بله می‌گیرید
- متغیر محیطی `BALE_ALLOWED_CHATS` (اختیاری): شناسه یا @username چت‌های مجاز، جدا شده با ویرگول؛ پیام بقیه چت‌ها نادیده گرفته می‌شود
- متغیر محیطی `BALE_MCP_DB` (اختیاری): اختیاری: مسیر فایلی روی کامپیوتر شما که تاریخچه پیام‌ها در آن ذخیره می‌شود (پیش‌فرض ~/.bale-mcp/messages.db)؛ با :memory: چیزی روی دیسک نمی‌ماند
- متغیر محیطی `BALE_MCP_SEND_DIRS` (اختیاری): اختیاری: پوشه‌هایی که بازو فقط از آن‌ها فایل می‌فرستد (پیش‌فرض: پوشه دانلود و پوشه‌ای که سرور در آن اجرا شده)؛ چند پوشه را در ویندوز با ; و در مک و لینوکس با : جدا کنید
- متغیر محیطی `BALE_MCP_PROXY` (اختیاری): اختیاری: نشانی یک پراکسی HTTP، اگر اینترنت شما به tapi.bale.ai وصل نمی‌شود

## ابزارها

- `bot_get_me`: امتحان توکن و نمایش مشخصات بازو
- `bot_get_chat`: مشخصات یک چت، آن‌طور که بازو آن را می‌بیند
- `bot_get_webhook_info`: وضعیت وب‌هوک (نشانی دریافت پیام‌ها) و به‌روزرسانی‌هایی که در صف مانده‌اند
- `bot_get_new_messages`: پیام‌های تازه همه چت‌ها از آخرین بررسی
- `bot_list_chats`: فهرست چت‌های بازو با تعداد پیام‌های خوانده‌نشده
- `bot_read_chat`: پیام‌های اخیر یک چت، هم فرستاده‌ها و هم دریافتی‌ها
- `bot_search_messages`: جستجو در پیام‌های ذخیره‌شده، سازگار با نوشتار فارسی
- `bot_wait_for_reply`: منتظر ماندن تا کسی در چت چیزی بنویسد یا دکمه‌ای را بزند
- `bot_send_message`: فرستادن پیام متنی از طرف بازو
- `bot_send_file`: فرستادن عکس، سند، ویدیو، صدا یا پیام صوتی
- `bot_edit_message`: ویرایش متن پیامی که بازو فرستاده است
- `bot_delete_message`: حذف یک پیام (برگشت‌پذیر نیست)
- `bot_download_file`: ذخیره فایلی که برای بازو فرستاده شده، روی همین کامپیوتر (تا ۲۰ مگابایت)

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

- پیام‌های جدید بله را بخوان و خلاصه‌شان را بگو.
- وقتی تست‌ها تمام شد، خلاصه نتیجه را در بله برایم بفرست.
- در بله از من بپرس دیپلوی کنم یا نه، با دکمه بله/خیر، و منتظر جوابم بمان.

## توضیحات

با این ابزار، دستیار هوش مصنوعی شما از طریق بازوی (ربات) بله خودتان پیام می‌خواند و می‌فرستد. مثلاً می‌تواند در بله سؤالی از شما بپرسد و منتظر جوابتان بماند.

این سرور روی کامپیوتر شما اجرا می‌شود، ۱۳ قابلیت دارد و از Bot API رسمی بله استفاده می‌کند. دستیار می‌تواند پیام‌ها را بخواند و جستجو کند، جواب و فایل بفرستد، و پیام‌های بازو را ویرایش یا حذف کند. فقط پیام‌هایی را می‌بیند که به بازو فرستاده می‌شود و نمی‌تواند با حساب شخصی شما وارد شود.

قابلیت‌های ارسال، ویرایش و حذف روی پیام‌های واقعی کار می‌کنند. پس از برنامه‌ای استفاده کنید که پیش از اجرای هر قابلیت از شما تأیید می‌گیرد. اگر `BALE_ALLOWED_CHATS` را تنظیم کنید، فقط چت‌های خودتان خوانده می‌شود و پیام غریبه‌ها به دستیار نمی‌رسد.

#### نکته‌ها

- تاریخچه پیام‌ها فقط روی کامپیوتر خودتان ذخیره می‌شود.
- جستجو با نوشتار فارسی کنار می‌آید: «ی/ي»، «ک/ك»، اعداد فارسی و نیم‌فاصله فرقی نمی‌کنند.
- به IP ایران (اتصال از داخل ایران) نیاز ندارد: سرور بله از خروجی ترکیه هم جواب داد.
