mcp-vmanomaly

mcp-vmanomaly হলো মডেল কনটেক্সট প্রোটোকল (MCP) সার্ভারের একটি ওপেন-সোর্স বাস্তবায়ন, যা AI সহায়কদের (যেমন Claude, Cursor, VS Code Copilot এবং অন্যান্য) সাথে ভিক্টোরিয়ামেট্রিক্স অ্যানোমালি ডিটেকশন (vmanomaly)-কে সংযুক্ত করে। এটি একটি চলমান vmanomaly ইনস্ট্যান্সের সাথে তার REST API-এর মাধ্যমে যোগাযোগ করার জন্য AI এজেন্টদের জন্য বিভিন্ন টুল উন্মুক্ত করে, যার মধ্যে রয়েছে স্বাস্থ্য পর্যবেক্ষণ, মডেল আবিষ্কার ও বৈধতা, YAML কনফিগারেশন তৈরি, অ্যানোমালি স্কোর মেট্রিক্স থেকে VMAlert নিয়ম তৈরি, টাইম-সিরিজ প্রোফাইলিং, শেয়ার্ড অটোটিউন কাজ এবং ফাজি ম্যাচিং সহ সম্পূর্ণ-টেক্সট ডকুমেন্টেশন অনুসন্ধান। সার্ভারটি এমবেডেড, আপ-টু-ডেট vmanomaly ডকুমেন্টেশন সহ আসে, যাতে নেটওয়ার্ক অ্যাক্সেস ছাড়াই ডকুমেন্টেশন অনুসন্ধান অফলাইনে কাজ করে। এটি তিনটি ট্রান্সপোর্ট মোড সমর্থন করে: stdio (ডিফল্ট, স্থানীয় একক-ব্যবহারকারীর জন্য), Streamable HTTP (/mcp উন্মুক্ত করে) এবং লিগ্যাসি SSE ট্রান্সপোর্ট (/sse এবং /message উন্মুক্ত করে)। কনফিগারেশন সম্পূর্ণরূপে পরিবেশ ভেরিয়েবল দ্বারা পরিচালিত হয়, যার মধ্যে রয়েছে vmanomaly এন্ডপয়েন্ট URL, bearer টোকেন (বা মাউন্ট করা সিক্রেটের জন্য টোকেন ফাইল), কাস্টম HTTP হেডার, অনুরোধের টাইমআউট, টুল অ্যালোলিস্ট/ডেনাইলিস্ট, রিসোর্স টগল, হার্টবিট ইন্টারভাল এবং লগ লেভেল/ফাইল। সার্ভারটি অপারেশনাল মনিটরিংয়ের জন্য Prometheus-ফরম্যাট /metrics, /health/liveness এবং /health/readiness এন্ডপয়েন্টও উন্মুক্ত করে। ইনস্টলেশন বিকল্পগুলির মধ্যে রয়েছে Go install, GitHub Releases থেকে প্রি-বিল্ট বাইনারি (চেকসাম এবং বিল্ড-প্রোভেন্যান্স অ্যাটেস্টেশন যাচাই সহ), ghcr.io থেকে Docker ইমেজ এবং সোর্স থেকে বিল্ড করা। Cursor, Claude Desktop, Claude Code, Visual Studio Code, Zed, JetBrains IDEs এবং Windsurf-এর জন্য ক্লায়েন্ট সেটআপ নির্দেশাবলী প্রদান করা হয়েছে, প্রতিটির সাথে JSON কনফিগারেশন স্নিপেট রয়েছে। স্থানীয় বাইনারি চালানো অবাস্তব এমন পরিবেশের জন্য একটি Docker-ভিত্তিক ক্লায়েন্ট কনফিগারেশনও অন্তর্ভুক্ত করা হয়েছে। নিরাপত্তা নির্দেশিকা ব্যাপক: সার্ভারটি প্রক্রিয়া-ব্যাপী bearer টোকেন ব্যবহার করে অনুরোধ ফরওয়ার্ড করে এবং প্রতি-ব্যবহারকারী পরিচয় বা টেন্যান্ট বিচ্ছিন্নতা প্রয়োগ করে না। ডকুমেন্টেশনটি স্থানীয় একক-ব্যবহারের জন্য stdio, দূরবর্তী HTTP/SSE অ্যাক্সেসের জন্য প্রমাণিত TLS রিভার্স প্রক্সি (যেমন vmauth), সর্বনিম্ন-অধিকার vmanomaly ক্রেডেনশিয়াল এবং টুল অ্যালোলিস্ট/ডেনাইলিস্ট প্রয়োগের সুপারিশ করে। এটি স্পষ্টভাবে একটি একক স্ট্যাটিক MCP ক্রেডেনশিয়ালের পিছনে একাধিক অবিশ্বস্ত ডোমেইন রাখার বিরুদ্ধে সতর্ক করে এবং একটি লজিক্যাল vmanomaly ইনস্টলেশনকে একটি বিশ্বস্ত ডোমেইন হিসাবে বিবেচনা করার পরামর্শ দেয়। টুলসেটটি বিভাগগুলিতে সংগঠিত: স্বাস্থ্য ও তথ্য (4টি টুল), মডেল কনফিগারেশন (4টি টুল), কনফিগারেশন বৈধতা (1টি টুল), ডকুমেন্টেশন অনুসন্ধান (1টি টুল), সামঞ্জস্য পরীক্ষা (1টি টুল), অ্যালার্টিং নিয়ম তৈরি (1টি টুল) এবং বিশ্লেষণ ও অটোটিউন (4টি টুল)। অটোটিউন কাজগুলি অপ্টিমাইজেশন বাজেট প্যারামিটার (ট্রায়াল, টাইমআউট, উন্নত Optuna প্যারামিটার) গ্রহণ করে এবং নমুনা করা টাইম সিরিজ জুড়ে প্রোডাকশন-রেডি মডেল কনফিগারেশনের জন্য সুপারিশ ফেরত দেয়। সার্ভারের জন্য মূল টুলসেটের জন্য vmanomaly 1.28.3+, টাইম-সিরিজ বৈশিষ্ট্য এবং টাস্ক-ভিত্তিক শেয়ার্ড অটোটিউনের জন্য 1.30.0+ এবং নামযুক্ত-কোয়েরি শেয়ার্ড অটোটিউন এবং VMUI-তে কোয়েরি-পলিসি পরামর্শের জন্য 1.30.5+ প্রয়োজন। সোর্স থেকে বিল্ড করার জন্য Go 1.24+ প্রয়োজন।