README.mdβ’2.75 kB
# MCP Greetings Server
A multilingual greetings server for the Model Context Protocol (MCP). Say hello to users in 7 different languages with a simple, lightweight MCP server.
## π Features
- **Multilingual Support**: 7 languages including English, Spanish, French, German, Japanese, Chinese, and Korean
- **AI Assistant Ready**: Compatible with Claude Desktop, Cursor IDE, ChatGPT, and other AI models
- **Easy Installation**: Available as NPM package with one command
- **JSON-RPC 2.0 Compliant**: Full Model Context Protocol specification compliance
- **Lightweight**: Fast Go implementation with minimal dependencies
- **Cross-Platform**: Works on Windows, macOS, and Linux
## π Quick Start
### Installation
```bash
# Install via NPM
npm install -g @mochammadshenna/mcp-greetings
# Or use directly without installation
npx @mochammadshenna/mcp-greetings
```
### Basic Usage
The server provides a `sayGreetings` tool that can greet users in different languages:
```json
{
"name": "sayGreetings",
"arguments": {
"name": "Alice",
"language": "Spanish"
}
}
```
**Response:** `Β‘Hola, Alice!`
## π§ Integration
### Claude Desktop
Add to your Claude Desktop configuration (`~/.config/claude-desktop/config.json`):
```json
{
"mcpServers": {
"greetings": {
"command": "npx",
"args": ["@mochammadshenna/mcp-greetings"]
}
}
}
```
### Cursor IDE
Add to your Cursor configuration (`~/.cursor/mcp.json`):
```json
{
"mcpServers": {
"greetings": {
"command": "npx",
"args": ["@mochammadshenna/mcp-greetings"]
}
}
}
```
## π Supported Languages
| Language | Code | Example |
|----------|------|---------|
| English | English | Hello, John! |
| Spanish | Spanish | Β‘Hola, John! |
| French | French | Bonjour, John! |
| German | German | Hallo, John! |
| Japanese | Japanese | γγγ«γ‘γ―, John! |
| Chinese | Chinese | δ½ ε₯½, John! |
| Korean | Korean | μλ
νμΈμ, John! |
## π Documentation
- [Installation Guide](installation.md) - Detailed installation instructions
- [API Reference](tools.md) - Complete tool documentation
- [Integration Guides](claude-desktop.md) - Setup for different AI assistants
- [Development](development.md) - Contributing and development
## π€ Contributing
We welcome contributions! Please see our [Contributing Guide](contributing.md) for details.
## π License
MIT License - see [LICENSE](https://github.com/mochammadshenna/mcp-greetings/blob/main/LICENSE) for details.
## π Support
- [GitHub Issues](https://github.com/mochammadshenna/mcp-greetings/issues) - Bug reports and feature requests
- [FAQ](faq.md) - Common questions and answers
- [Troubleshooting](troubleshooting.md) - Common issues and solutions