وقتی با Postman یک MCP Server تولید میکنید، برای هر request انتخابشده یک tool ساخته میشود. بعد از راهاندازی سرور در سیستم محلی، میتوانید از Postman برای تعامل با سرور و آزمایش رفتار آن استفاده کنید.
سرور تولیدشده از دو روش ارتباطی پشتیبانی میکند: STDIO و streamable HTTP. بسته به ابزار یا hostی که قرار است به MCP Server وصل شود، میتوانید یکی از این دو روش را اجرا کنید.
راهاندازی MCP Server
- اگر هنوز انجام ندادهاید، Node.js نسخه ۱۸ یا جدیدتر را نصب کنید و MCP Server را از Postman تولید و دانلود کنید.
- فایل ZIP دانلودشده را از حالت فشرده خارج کنید.
- در صورت نیاز، پوشه خارجشده را تغییر نام دهید یا آن را به مسیر مناسبتری منتقل کنید.
- ترمینال را باز کنید و وارد ریشه پروژه MCP Server شوید:
cd /path/to/your-mcp-server
- وابستگیهای پروژه را نصب کنید:
npm install
- فهرست toolهای تولیدشده را ببینید:
npm run list-tools
این دستور اطلاعات toolها، از جمله نام فایلهای مربوط به آنها را نمایش میدهد. معمولا فایلهای tool در پوشه tools قرار دارند و ممکن است لازم باشد در مراحل بعدی آنها را ویرایش کنید.
- برای هر tool، فایل مربوط به آن را باز کنید و مطمئن شوید مقدار
baseUrlدرست است. - اگر باید دادههای حساس مثل API key یا token را نگه دارید، فایل
.envرا باز کنید و مقدارها را آنجا ذخیره کنید. - اگر یک tool به احراز هویت نیاز دارد، فایل همان tool را باز کنید و مقدار
tokenرا در بخش مناسب استفاده کنید. برای مثال اگر request اصلی توکن را در header میفرستاد، توکن را درheadersاضافه کنید.
برای جزئیات بیشتر، فایل README.md پروژه تولیدشده را هم بخوانید؛ معمولا دستورها و نکتههای مخصوص همان سرور در آن آمده است.
شروع MCP Server
- ترمینال را باز کنید و وارد ریشه پروژه سرور شوید:
cd /path/to/your-mcp-server
- برای اجرای سرور با روش STDIO این دستور را اجرا کنید:
node mcpServer.js
اگر میخواهید سرور را با روش streamable HTTP اجرا کنید، این دستور را بزنید:
node mcpServer.js --streamable-http
- وقتی کارتان با سرور تمام شد، با Control + C یا Ctrl + C آن را متوقف کنید.
قبل از تعامل با سرور بررسی کنید
- وابستگیها بدون خطا نصب شده باشند.
- فایلهای tool مسیر درست API را داشته باشند.
- کلیدها و توکنها در فایل
.envیا سازوکار امن مشابه نگهداری شوند. - روش اجرای انتخابشده، یعنی STDIO یا streamable HTTP، با ابزار مقصد شما سازگار باشد.
بعد از این مرحله، آمادهاید با Postman به MCP Server وصل شوید و toolهای تولیدشده را همراه یک مدل هوش مصنوعی آزمایش کنید.
منبع آموزشی: Postman Docs، بازنویسی و سادهسازیشده برای کاربران فارسیزبان.