Hello-MCP

🚀 Hello MCP(Model Context Protocol)

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

한국어 버전은 아래 링크에서 확인할 수 있습니다. 한국어 버전

English Version is available at the following link. English Version

✨ 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.

(English) Hello, Welcome! (Korean) 안녕하세요, 환영합니다!

🛠️ 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
Internationalization: Supports multiple languages (Korean and English)

📋 Requirements

Node.js 14+ Download
Claude Desktop installed (Download here)
Internet connection for Email Sending GARAK 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.

🔑 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 add 1" (Simple calculation)
"Send an email to [your-email] with the result of 1 add 1"

🤝 Support

If you encounter any issues, please contact us at help@garak.ai

📚 Documentation

For more examples and tips, visit our getting started guide: Getting Started Guide

You can also browse our interactive documentation:

Run locally: npx docsify-cli serve docs
View in your browser: http://localhost:3000

🚧 TODO

If you encounter any problems or have suggestions, please create an issue on a suitable issue tracking system (e.g., GitHub Issues). Provide a detailed description of the issue and steps to reproduce it. https://github.com/hongsw/hello-mcp/issues
Windows support is currently under testing.

📄 License

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