# نقشه نشان (Neshan Maps)

سرور MCP رسمی نقشه نشان: جستجوی مکان، نشانی، مسیریابی با ترافیک، ماتریس فاصله و محدودهٔ دسترسی. به کلید API نشان نیاز دارد

- نوع: سرور MCP
- دسته: نقشه و مکان
- منبع: رسمی
- همکار رسمی بازارچه MCP
- پیشنهادی بازارچه MCP
- سازنده: NeshanMaps (https://github.com/NeshanMaps)
- زبان: Python
- آخرین بررسی: 2026-11-14
- صفحه: https://mcpfarsi.ir/servers/neshan/
- مخزن: https://github.com/NeshanMaps/Neshan-MCP
- وب‌سایت سرویس: https://platform.neshan.org/mcp

## هشدارها

- نیازمند کلید API: برای کار کردن، کلید حساب خودتان در این سرویس لازم است.

## نصب

- نشانی سرور (http): https://api.neshan.org/mcp
- بدون نصب: از راه روتر MCP (https://mcp.mcpfarsi.ir/mcp، ورود با OAuth)؛ راهنما: https://mcpfarsi.ir/start/
- کلید باید دسترسی MCP داشته باشد؛ آن را با ثبت تیکت در پنل نشان بگیرید.
- متغیر محیطی `NESHAN_API_KEY` (لازم، محرمانه): کلید API (رمزی که نشان به شما می‌دهد) از پنل توسعه‌دهندگان نشان (platform.neshan.org)

## API نقشه نشان

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

```sh
curl "https://mcpfarsi.ir/api/v1/tools?q=neshan&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": "neshan", "tool": "search", "arguments": {}}'
```

## ابزارها

- `search`: جستجوی مکان، کسب‌وکار یا نشانی نزدیک یک نقطه با متن آزاد، با پیوند نمایش در نشان
- `geocode`: تبدیل نشانی متنی به مختصات، با چند پاسخ مرتب‌شده
- `reverse_geocode`: تبدیل مختصات به نشانی خوانا (خیابان، محله، شهر و استان)
- `list_search_layers`: فهرست دسته‌های مکانی که جستجو را با آن‌ها محدود می‌کنید
- `direction`: مسیر خودرو، موتورسیکلت یا پیاده بین دو نقطه، با توقف بین راه، حالت ترافیک و پرهیز از طرح ترافیک و زوج و فرد
- `distance_matrix`: فاصله و زمان رانندگی میان چند مبدأ و چند مقصد در یک درخواست
- `tsp`: بهترین ترتیب سر زدن به چند مقصد، با برگشت به مبدأ یا بدون آن
- `map_matching`: نشاندن یک رشته نقطهٔ خام GPS روی جادهٔ واقعی، با میزان اطمینان
- `isochrone`: محدوده‌ای که از یک نقطه تا فاصلهٔ مشخصی در دسترس است
- `static_map`: تصویر نقشه (PNG) با مرکز یک نقطه، با نشانگر یا لایهٔ نقطه و خط و چندضلعی
- `distance`: فاصلهٔ مستقیم دو نقطه، بی‌درنگ و بدون درخواست به سرور
- `bearing`: جهت قطب‌نمایی از یک نقطه به نقطهٔ دیگر
- `nearest_point`: نزدیک‌ترین نقطه به یک نقطهٔ مرجع از میان چند نقطه
- `points_within_polygon`: جدا کردن نقطه‌هایی که داخل یک چندضلعی هستند
- `bbox`: کوچک‌ترین مستطیلی که چند نقطه را در بر می‌گیرد
- `area`: مساحت یک چندضلعی روی زمین
- `buffer`: ساختن نوار یا محدوده‌ای با فاصلهٔ ثابت دور یک نقطه یا خط
- `decode_polyline`: باز کردن مسیر کدشده (polyline) به فهرست مختصات
- `ping`: آزمایش اتصال به سرور: همان پیام را برمی‌گرداند

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

- نزدیک‌ترین داروخانه به میدان ونک تهران کجاست؟
- نشانی دقیق برج میلاد را از نقشهٔ نشان پیدا کن.
- مسیر رانندگی از میدان آزادی تا فرودگاه امام خمینی را با ترافیک الان بگیر.
- برای سر زدن به این پنج نشانی در تهران، چه ترتیبی کوتاه‌تر است؟
- از این انبار تا شعاع پنج کیلومتری کدام محله‌ها در دسترس‌اند؟

## توضیحات

با این سرور، دستیار هوش مصنوعی شما (Claude، ChatGPT، Cursor و دیگران) می‌تواند در نقشهٔ نشان مکان و نشانی پیدا کند، مسیر بگیرد و کارهای مکانی مثل ترتیب چند مقصد یا محدودهٔ دسترسی را حساب کند. سازندهٔ آن خود نشان است و نشان همکار رسمی بازارچه MCP است.

فرقش با جواب دستیار از حافظه این است که مکان، نشانی، مسیر و ترافیک از دادهٔ نقشهٔ نشان می‌آید، نه از چیزی که دستیار پیش‌تر خوانده است؛ این برای نشانی‌های فارسی و شهرهای ایران مهم است. صفحهٔ معرفی [MCP نشان](https://platform.neshan.org/mcp) نمونه‌ها و تعرفه را نشان می‌دهد و [مستندات MCP نشان](https://platform.neshan.org/docs/mcp) راهنمای کامل اتصال است.

#### چه کارهایی می‌کند

- **جستجو و نشانی:** پیدا کردن مکان و کسب‌وکار با متن آزاد، تبدیل نشانی به مختصات و برعکس، و محدود کردن جستجو به دسته‌های مکانی.
- **مسیریابی:** مسیر خودرو، موتورسیکلت یا پیاده با ترافیک لحظه‌ای، با پرهیز از محدودهٔ طرح ترافیک و زوج و فرد.
- **لجستیک:** ماتریس فاصله و زمان میان چند مبدأ و مقصد، بهترین ترتیب چند توقف (TSP)، محدودهٔ دسترسی (ایزوکرون) و نشاندن ردّ GPS روی جاده.
- **نقشه:** تصویر نقشه با نشانگر، مسیر یا محدوده.
- **محاسبهٔ مکانی بدون هزینه:** فاصله، جهت، نزدیک‌ترین نقطه، مساحت و نقطه‌های داخل یک محدوده، بی‌آنکه درخواستی به نشان برود.

#### شروع کار

1. در [پنل نشان](https://platform.neshan.org) ثبت‌نام کنید و با ثبت تیکت، کلید API با دسترسی MCP بگیرید؛ کلید معمولی بدون این دسترسی برای سرور MCP کافی نیست.
2. نشانی سرور آماده را با کلیدتان در دستیار وارد کنید (راهنمای هر برنامه در همین صفحه آمده است)؛ چیزی نصب نمی‌شود.
3. یا از راه روتر MCP بازارچه وصل شوید و کلید را یک بار در داشبورد بگذارید.

#### نکته‌ها

- سرور آماده روی api.neshan.org کار می‌کند. نسخهٔ متن‌باز آن را هم می‌توانید از [مخزن گیت‌هاب نشان](https://github.com/NeshanMaps/Neshan-MCP) با پایتون یا Docker روی کامپیوتر خودتان اجرا کنید.
- مصرف از سهمیهٔ کلید خودتان کم می‌شود. تعرفهٔ MCP نشان در [صفحهٔ معرفی](https://platform.neshan.org/mcp) آمده است و برای کمک می‌توانید در پنل نشان تیکت بفرستید.
