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