Hello-MCP

by hongsw
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides a runtime environment for the MCP server, required for version 14 or higher to support the tool functionality.

  • Used to display status badges for Node.js version and license information in the project documentation.

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

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

-
security - not tested
A
license - permissive license
-
quality - not tested

A utility tool that enables Claude Desktop to interact with external tools via the Model Context Protocol, providing features like email sending and simple calculations while simplifying the MCP setup process.

  1. "Tour and Guide Tool for Setting Up Claude Desktop MCP Config Manager"
    1. ✨ Overview
      1. 🛠️ Features
        1. 📋 Requirements
          1. 🚀 Quick Start
            1. 🎮 Usage
              1. 1️⃣ Setup Mode (Default)
              2. 2️⃣ MCP Server Mode
            2. 🔑 API Keys
              1. 📊 Telemetry
                1. 🌟 Tips for Using with Claude
                  1. 🤝 Support
                    1. 📚 Documentation
                      1. 🚧 TODO
                        1. 📄 License