Model Context Protocol (MCP) ගැන කියන ලේඛන වල උදාහරණ බොහොමයක් අඩු තරමක හෝ වැඩි Boilerplate එකකින් වැසී තිබේ. මේ ලිපියෙන්, TypeScript භාවිතයෙන් සැබෑ MCP සර්වර් එකක් කෙලින්ම නිර්මාණය කරන්නේ කෙසේද, ඒකෙහි තුන්ම ප්රාථමික අංග (Tools, Resources, Prompts) සියල්ල ක්රියාත්මක කරන ආකාරය, සහ එය stdio හා HTTP දෙකම මඟින් සන්නිවේදනය කරන ආකාරය පිළිබඳව පියවරෙන් පියවරෙන් පැහැදිලි කරයි.
සාමාන්ය සෙට්‑අප් – MCP සර්වර් එක ස්වතන්ත්ර ක්රියාවලියක් ලෙස Node.js පරිසරයේ ධාවනය වේ. package.json හි bin කොටස ඇතුළත් කිරීමෙන්, npm හරහා npx ts-ai-mcp ලෙස සරලව ධාවනය කළ හැකිය. සර්වර් එක McpServer සහ StdioServerTransport භාවිතා කරයි; server.connect() ක්රියාවලිය non‑blocking වශයෙන් stdin/stdout පසුබැසීමේ ප්රොටෝකෝලය අරඹයි.
ස්ටැන්ඩර්ඩ් I/O (stdio) භාවිතයේ වැදගත් උපදෙස් – stdio මාර්ගය භාවිතා කරන විට, ලොග් පණිවුඩ සියල්ල stderr වෙත යැවිය යුතුය. console.log මගින් stdout වෙත ලියන විට JSON‑RPC ෆ්රේම් විකෘති වේ, එමනිසා සර්වර් පණිවුඩය විකෘතව හෝ අසාර්ථකව පාර්ස් කරයි. එබැවින් console.error('Server started') වැනි පරිදි ලොග් කිරීම අත්යවශ්ය වේ.
Tools අංගය ලියාපදිංචි කිරීම – SDK එකේ server.tool() ක්රමය භාවිතා කර, LLM එකට ඇමතුම් ලබා දිය හැකි ක්රියා (උදා: knowledge base query) සකස් කරයි. Zod වැනි schema validation library එක සමඟ පරාමිතීන් නිරූපණය කර, async function එකක් තුළ RAG සේවාවට HTTP POST ඇමතුමක් කර, ප්රතිඵලය citations සමඟ ආපසු ලබා දේ.
ශ්රී ලංකාවට ඇති වැදගත්කම
මෙම උදාහරණය ශ්රී ලංකාවේ දැනුම් පදනම සහ සංවර්ධන කණ්ඩායම් සඳහා බොහෝ ප්රයෝජන ලබා දේ:
- දැනුම් ව්යාප්තිය – AI‑driven applications සඳහා MCP ප්රෝටෝකෝලය අත්හදා බැලීම, දේශීය විශ්වවිද්යාල සිසුන්ට අන්තර්ජාල‑මූලික AI සේවා නිර්මාණය කිරීමට නව දෘශ්යමාර්ගයක් සපයයි.
- ව්යාපාරික නව්යකරණය – ශ්රී ලංකාවේ ස්ටාර්ට්‑අප් හෝ IT සමාගම්ට, TypeScript සහ Node.js භාවිතයෙන් ඉතා ඉක්මණින් production‑grade AI‑backend එකක් සකස් කර, ගනුදෙනුකරුවන්ට AI‑assisted සේවා (chatbot, knowledge‑base search) ලබා දීමට හැකියාව ලැබේ.
- කොඩ්‑ගුණාත්මකත්වය – stdio logging, JSON‑RPC serialization වැනි නියමිත best practice ගත කිරීම, දේශීය සංවර්ධකයින්ට අධි‑ගුණාත්මක, maintainable codebase එකක් ගොඩනැගීමට මාර්ගෝපදේශයක් වේ.
අවසානයේ, මෙම MCP සර්වර් ගොඩනැගීමේ ක්රියාවලිය, AI, API, cloud තාක්ෂණයන් සමඟ සම්බන්ධ වීමට අවශ්ය මූලික හැකියාවන් ලබා දෙන අතර, ශ්රී ලංකාවේ තාක්ෂණික පරිසරය තවත් වර්ධනය කරයි.
