🚀 Hello MCP(Model Context Protocol)

"Tour and Guide Tool for Setting Up Claude Desktop MCP Config Manager"

✨ Overview

Hello-MCP is a helpful utility tool that enables Claude Desktop to interact with external tools via the Model Context Protocol (MCP). It simplifies the setup process and provides a seamless integration between Claude AI and your custom tools.

🛠️ Features

• Easy Setup: Simple one-command setup for Claude Desktop MCP integration
• Multiple Modes: Run as a setup wizard, MCP server, or CLI tool
• Built-in Sample Tools: Pre-configured tools like email sending and simple calculations
• Extensible: Easily add your own MCP tools

📋 Requirements

• Node.js 14+
• Claude Desktop installed (Download here)
• Internet connection for API key generation

🚀 Quick Start

You can run Hello-MCP without installation using npx:

npx hello-mcp

This will start the setup wizard that guides you through the entire configuration process.

🎮 Usage

Hi-Garak can be used in three different modes:

1️⃣ Setup Mode (Default)

npx hello-mcp
# or
npx hello-mcp setup

This interactive mode will:

• Check if Claude Desktop is installed
• Ask for your email and purpose
• Generate an API key
• Configure Claude Desktop for MCP
• Restart Claude Desktop automatically (when possible)

2️⃣ MCP Server Mode

npx hello-mcp mcp-server

This starts Hello-MCP as an MCP server that Claude Desktop can connect to. The server provides tools that Claude can use to perform actions.

3️⃣ CLI Mode

npx hello-mcp cli [command] [options]

Available commands:

• add: Add two numbers

  npx hello-mcp cli add 3 5

• send-email: Send an email

  npx hello-mcp cli send-email [email protected] "Hello from Hello-MCP!"

🔑 API Keys

Your API key is stored in ~/.garakrc and has a daily limit of 50 requests. The key is automatically configured for use with Claude Desktop.

📊 Telemetry

Hello-MCP collects anonymous usage data to improve the service:

• User interactions and performance metrics
• All data is anonymized
• You can disable telemetry in the configuration

🌟 Tips for Using with Claude

After setup, you can try these prompts with Claude:

1. "1 add 1" (Simple calculation)
2. "Send an email to [your-email] with the result of 1 add 1"

🤝 Support

If you encounter any issues, please contact us at [email protected]

📚 Documentation

For more examples and tips, visit our guide: https://garak.ai/getting-started

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.