MCP_Server_DiwaliWishes

SripriyaPKulkarni/MCP_Server_DiwaliWishes

3.2

If you are the rightful owner of MCP_Server_DiwaliWishes and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Diwali Wishes MCP Server is a TypeScript-based server that generates culturally accurate Diwali greetings in multiple Indian languages, tailored to the user's state, and operates entirely offline.

Tools
1
Resources
0
Prompts
0

🪔 Diwali Wishes MCP Server

A Model Context Protocol (MCP) server built using TypeScript that generates Diwali greetings in multiple Indian languages based on the user's state. The server detects the regional language for the given state and responds with a warm, culturally accurate wish — completely offline (no external API required).

✨ Features

  • 🎇 Generates Diwali wishes in multiple Indian languages.
  • 🗺️ Automatically detects language from Indian state.
  • 💬 Works offline, with pre-defined local translations.
  • ⚙️ Built using @modelcontextprotocol/sdk and TypeScript.
  • 🚀 Can be extended to support personalized or bulk greetings.

📂 Project Structure

mcp-server-diwali-wishes/
├── diwaliMcpServer.ts   # Main MCP server script
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
└── README.md             # Documentation (this file)

⚙️ Installation

  1. Clone the repository
git clone https://github.com/SripriyaPKulkarni/mcp-server-diwali-wishes.git
cd mcp-server-diwali-wishes
  1. Install dependencies
npm install
  1. Build or run with ts-node

If you have ts-node installed globally:

ts-node diwaliMcpServer.ts

Or use npx:

npx ts-node diwaliMcpServer.ts

🪄 Usage

Once the server is running, it exposes a tool called get-wishes.

Example Input

{
  "tool": "get-wishes",
  "parameters": {
    "state": "Gujarat"
  }
}

Example Output

{
  "content": [
    {
      "type": "text",
      "text": "🪔 તમને દિવાળી મુબારક! (Gujarati)"
    }
  ]
}

🌐 Supported States & Languages

StateLanguageSample Wish
MaharashtraMarathiतुम्हाला दिवाळीच्या हार्दिक शुभेच्छा!
GujaratGujaratiતમને દિવાળી મુબારક!
TamilNaduTamilஉங்களுக்கு தீபாவளி வாழ்த்துகள்!
KarnatakaKannadaನಿಮಗೆ ದೀಪಾವಳಿ ಹಬ್ಬದ ಶುಭಾಶಯಗಳು!
WestBengalBengaliআপনাকে দীপাবলির শুভেচ্ছা!
PunjabPunjabiਤੁਹਾਨੂੰ ਦੀਵਾਲੀ ਮੁਬਾਰਕ!
KeralaMalayalamനിനക്ക് ദീപാവലി ആശംസകൾ!
OdishaOdiaଆପଣଙ୍କୁ ଦୀପାବଳିର ଶୁଭେଚ୍ଛା!
DelhiHindiआपको दीवाली की हार्दिक शुभकामनाएं!

(and many more...)

🔧 Configuration Details

The MCP server is powered by:

  • McpServer – core protocol server.
  • StdioServerTransport – handles communication.
  • zod – for request validation.

Tool Definition

  • Tool name: get-wishes
  • Input parameter: state (string)
  • Output: localized Diwali wish text

🧠 How It Works

  1. User sends a state name.
  2. Server looks up the language for that state.
  3. Server fetches the predefined greeting in that language.
  4. The response is sent back as a structured text message.

💡 Example Use Cases

  • 🤖 Integrate into a GenAI agent to send festive greetings.
  • 🧭 Use inside a Model Context Protocol ecosystem.
  • 🎉 Automate festival messages for regional audiences.

📜 License

This project is licensed under the MIT License — feel free to modify and share.

🪔 Developed By Sri Priya P Kulkarni

Developed by Priya Kulkarni with ❤️ and festive spirit. Wishing you and your loved ones a Happy Diwali full of light, peace, and prosperity!