README.mdβ’3.44 kB
# MCP Greetings Server
A multilingual greetings Model Context Protocol (MCP) server built with the official Go SDK. Greet users in multiple languages with enterprise-grade performance and reliability.
## Features
- π **Multilingual Support**: Greet users in 7 different languages
- π **Official Go SDK**: Built with Google-maintained MCP Go SDK
- π¦ **Pure Go Binary**: No Node.js dependencies, single executable
- π§ **MCP Compatible**: Works with Claude Desktop, Cursor, and other MCP clients
- β‘ **High Performance**: ~50ms response time, enterprise-grade reliability
## Supported Languages
- English (default)
- Spanish
- French
- German
- Japanese
- Chinese
- Korean
## Installation
### Quick Install (Linux/macOS)
```bash
curl -L https://github.com/mochammadshenna/mcp-greetings/releases/download/v1.1.0/install.sh | bash
```
### Manual Install
1. Download the binary for your platform from [Releases](https://github.com/mochammadshenna/mcp-greetings/releases)
2. Make it executable: `chmod +x mcp-greetings-*`
3. Move to your PATH: `sudo mv mcp-greetings-* /usr/local/bin/mcp-greetings`
## Usage
### With Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"greetings": {
"command": "mcp-greetings"
}
}
}
```
### With Cursor
Add to your `~/.cursor/mcp.json`:
```json
{
"mcpServers": {
"greetings": {
"command": "mcp-greetings"
}
}
}
```
## Tool: sayGreetings
### Parameters
- `name` (required): Name of the person to greet
- `language` (optional): Language for greeting (default: English)
### Supported Languages
- `English` - "Hello, {name}!"
- `Spanish` - "Β‘Hola, {name}!"
- `French` - "Bonjour, {name}!"
- `German` - "Hallo, {name}!"
- `Japanese` - "γγγ«γ‘γ―, {name}!"
- `Chinese` - "δ½ ε₯½, {name}!"
- `Korean` - "μλ
νμΈμ, {name}!"
### Example Usage
```
Use the sayGreetings tool to greet John in Spanish
```
This will return: "Β‘Hola, John!"
## Development
### Prerequisites
- Node.js 18+
- Go 1.21+
### Building
```bash
# Install dependencies
npm install
# Build binaries for all platforms
node build.js
# Test locally
npm start
```
### Publishing
```bash
# Login to npm
npm login
# Publish
npm publish
```
## Architecture
This MCP server is built with the official Go SDK:
1. **Official Go SDK** (`github.com/modelcontextprotocol/go-sdk`): Google-maintained MCP implementation
2. **Pure Go Binary**: Single executable with no dependencies
3. **Cross-platform Build**: Automated builds for macOS, Linux, Windows (Intel & ARM)
4. **Simple Installation**: Direct binary download and installation
## License
MIT
## Author
**Mochammad Shenna**
- GitHub: [@mochammadshenna](https://github.com/mochammadshenna)
- Email: <shenawardana@gmail.com>
## Contributing
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## Changelog
### v1.1.0
- **Official Go SDK**: Migrated to Google-maintained MCP Go SDK
- **78% code reduction**: From 236 lines to ~50 lines
- **Better performance**: ~50ms response time
- **Enterprise-grade**: Production-ready with official support
### v1.0.0
- Initial release
- Support for 7 languages
- Cross-platform binary distribution
- MCP protocol compliance