home / mcp / hello mcp server

Hello MCP Server

hello-mcp is a tour and guide for beginners to Claude Desktop MCP Config Manager, designed to help them understand MCP (Model Context Protocol)

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "hongsw-hello-mcp": {
      "command": "npx",
      "args": [
        "hello-mcp",
        "setup"
      ]
    }
  }
}

Hello MCP enables Claude Desktop to connect with external tools via the Model Context Protocol, making it easy to run your own tools and automate actions from Claude. This server-focused setup guides you through using the MCP client and running a local MCP server to extend Claude’s capabilities with your own tools and workflows.

How to use

You can use the MCP server with an MCP client by running the provided commands from your terminal. The setup flow configures Claude Desktop to communicate with MCP-enabled tools, and you can switch between running a setup wizard and hosting a local MCP server. After setup, you can interact with built-in sample tools like email sending and simple calculations, or add your own tools to extend Claude’s capabilities. When you start the MCP server, Claude Desktop can connect and perform actions through the configured tools.

How to install

npm --version
node -v
```

Prerequisites
- Node.js 14+
- Claude Desktop installed
- Internet access for initial setup (for API key generation if you plan to enable email sending via GARAK)

How to use (commands)

Use the following commands to operate Hello MCP from your terminal. The setup flow will guide you through installation checks, API key creation, and Claude Desktop configuration. You can also start an MCP server to expose tools directly to Claude Desktop.

npx hello-mcp
```

Start in setup mode (default) to run the interactive wizard:

```
npx hello-mcp setup
```

Start in MCP server mode to expose tools to Claude Desktop:

```
npx hello-mcp mcp-server
```

After setup completes, Claude Desktop will be configured to use MCP and may restart automatically when possible.

Notes on API keys and telemetry

Your API key is stored locally and is used with Claude Desktop. Telemetry is collected optionally to improve the service and can be disabled in the configuration.

Sample prompts after setup

Try these prompts with Claude to verify the integration once the setup completes: - 1 add 1 - Send an email to [email protected] with the result of 1 add 1

Support

If you encounter issues, contact support for assistance at [email protected].

Documentation and tips

For getting started and exploring more examples, use the built-in guidance and examples provided by the MCP setup flow. You can run local docs to explore features interactively.

Troubleshooting

If Claude Desktop does not appear to connect, re-run the setup in setup mode or restart Claude Desktop after enabling the MCP configuration. Ensure Node.js is installed and the CLI commands are available in your shell path.

Security and notes

Only enable MCP features you trust. Keep your API keys secure and do not share them. Review any permissions requested by newly added tools.