mcp-greeting

The MCP Greeting Server provides time-aware, multi-language greetings that can be accessed by MCP clients such as Claude. It can return a personalized greeting in English, Portuguese, Spanish, or French, adjusting the message based on the current time in the selected timezone. By default it uses a Sao Paulo timezone if none is provided, and it supports an optional name parameter to personalize the greeting. You can invoke the server directly via the MCP tools API (greet) and also integrate it with Claude using either a Claude Desktop or Web/API configuration. The server exposes a greet tool that returns a text response with an appropriate emoji and time information, reflecting morning, afternoon, or evening greetings in the chosen language. Timezone and language can be overridden to tailor the greeting to different contexts or locales.

Prerequisites:

• Node.js 18+
• npm or yarn

Installation steps:

1. Clone the repository git clone https://github.com/gustavorobertux/mcp-greeting-server.git
2. Navigate to the project folder cd mcp-greeting-server
3. Install dependencies npm install
4. Start the server npm start

If you prefer to run directly for testing:

• Ensure index.js is the entry point and executable
• Start with node index.js

Notes:

• The server is designed to be used as an MCP server compatible with Claude and other MCP clients. You can configure your MCP client to point to the local or deployed index.js entry point using the provided mcpServers.greeting configuration.

Tips:

• You can customize default behavior via MCP client configuration by specifying timezone (e.g., America/New_York) and language (en, pt, es, fr) when calling greet.
• If you encounter issues, ensure Node.js is in your PATH and that the path to index.js in your MCP client configuration is absolute.
• The greeting results include an emoji and a time snippet, with translations for the supported languages. To add new languages, extend the greetings object and update the README accordingly.
• If you plan to publish a package for NPX usage, ensure the package.json provides the appropriate name and bin entry as needed for npx invocation.