معرفی MCP نشان (Neshan MCP Server)
سرور MCP نشان، دستیارها و ایجنت‌های هوش مصنوعی مثل Claude Desktop یا Cursor را به قابلیت‌های نقشه‌ی نشان وصل می‌کند. پس از اتصال، کاربر می‌تواند به زبان معمولی در گفت‌وگو بپرسد «مسیر خانه تا محل کارم را با ترافیک الان نشانم بده» یا «نزدیک‌ترین کافه به این مختصات کجاست؟» و پاسخ را همان‌جا دریافت کند.
این پروژه یک MCP Server است: یک رابط استاندارد که سرویس‌های نشان را طوری در اختیار ایجنت قرار می‌دهد که خود ایجنت در لحظه تصمیم بگیرد از کدام سرویس استفاده کند. کد پروژه در گیت‌هاب نشان در دسترس است.
آشنایی بیشتر با MCP نشانقابلیتها
پس از اتصال سرور به ایجنت، این کارها با درخواست به زبان طبیعی انجام می‌شود:
- جستجوی مکان: پیدا کردن آدرس، کسب‌وکار یا نقطه‌ی مورد نظر با نام یا توضیح.
- تبدیل آدرس و مختصات: گرفتن آدرس از روی مختصات جغرافیایی یا برعکس.
- مسیریابی: مسیر بین دو یا چند نقطه برای خودرو، موتورسیکلت یا پیاده؛ با ترافیک لحظه‌ای، بدون ترافیک، یا براساس الگوی معمول و تاریخی ترافیک.
- بهینه‌سازی مسیر چندتوقفه (TSP): بهترین ترتیب بازدید از چند مقصد.
- تطبیق مسیر با جاده (Map Matching): تبدیل یک رشته نقطه‌ی خام GPS به مسیر واقعی روی جاده.
- محدوده‌ی دسترس‌پذیری (Isochrone): محدوده‌ای که در زمان یا فاصله‌ی مشخص از یک نقطه قابل دسترسی است.
- ماتریس فاصله و زمان: فاصله و زمان سفر بین چند مبدأ و مقصد به‌صورت هم‌زمان.
- مسیریابی ناوگان (VRP): تخصیص بهینه‌ی سفارش‌ها به چند وسیله‌ی نقلیه با در نظر گرفتن ظرفیت و بازه‌ی زمانی.
- نقشه‌ی استاتیک: تصویر نقشه از یک نقطه، یا نقشه‌ای با کمان بین مبدأ و مقصد.
- نقشه‌ی تعاملی: ساخت یک صفحه‌ی نقشه با نشانگر و مسیر که در مرورگر باز می‌شود.
- تحلیل ترافیک: وضعیت ترافیک یک منطقه در ۲۴ ساعت گذشته.
- جزئیات یک مکان: اطلاعات کامل یک نتیجه‌ی جستجو، مانند آدرس، دسته‌بندی و محله.
همه‌ی این کارها از طریق گفت‌وگوی طبیعی با ایجنت انجام می‌شود و کاربر نهایی لازم نیست چیزی درباره‌ی API یا اندپوینت‌ها بداند. فهرست فنی ابزارها و پارامترهایشان در صفحه‌ی فهرست ابزارها آمده است.
شروع سریع: استفاده از سرور آماده‌ی نشان
ساده‌ترین روش، اتصال به سرور آماده‌ی نشان است و به نصب یا اجرای هیچ برنامه‌ای نیاز ندارد.
برای دریافت کلید با دسترسی به سرویس MCP، از طریق ارسال تیکت در پنل کاربری نشان با پشتیبانی تماس بگیرید.
پس از دریافت کلید، این تنظیمات را به فایل تنظیمات کلاینت خود (Claude Desktop، Cursor و…) اضافه کنید و <YOUR_API_KEY> را با کلید خود جایگزین کنید:
{
"mcpServers": {
"neshan": {
"url": "https://api.neshan.org/mcp",
"headers": {
"Api-Key": "<YOUR_API_KEY>"
}
}
}
}
از این لحظه ایجنت شما به قابلیت‌های نقشه‌ی نشان دسترسی دارد.
روش‌های استفاده
| روش | مناسب برای | راهنما |
|---|---|---|
| سرور آماده‌ی نشان (HTTP) | شروع سریع، بدون نصب و نگهداری | همین صفحه و اتصال کلاینت‌ها |
| اجرا روی سیستم یا سرور خودتان | اجرای محلی با Python یا Docker و کنترل کامل روی کلیدها | اجرا روی سرور خودتان |
در هر دو روش، نحوه‌ی ارسال داده و فراخوانی ابزارها یکسان است.
گام بعدی
- اتصال کلاینت‌ها: تنظیمات Claude Desktop، Cursor و کلاینت‌های HTTP.
- اجرا روی سرور خودتان: نصب، تنظیم کلید، اجرا با Python و Docker.
- فهرست ابزارها: ابزارهایی که سرور در اختیار ایجنت می‌گذارد و سرویس نشان پشت هر کدام.
- سوالات متداول: رفع خطاهای رایج کلید و دسترسی.