한국어 버전은 아래 링크에서 확인할 수 있습니다.
한국어 버전
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 [email protected]
? 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.