hello-mcp
Facilitates integration of Claude Desktop with external tools using the Model Context Protocol, enabling seamless tool interaction and custom tool extensions.
Author

hongsw
Quick Info
Actions
Tags
🚀 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. "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 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.
