home / mcp / hello mcp server

Hello MCP Server

Exposes an MCP endpoint for interactive testing and deployment with a simple HTTP endpoint and local dev workflow.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "badroobot-test_m": {
      "url": "http://localhost:8081/mcp",
      "headers": {
        "Smithery_API_KEY": "sk_abcdefghijklmnopqrstuvwxyz"
      }
    }
  }
}

You run a lightweight MCP server that exposes a dedicated control plane at an MCP endpoint. It lets you connect an MCP client to manage capabilities, test interactive tools, and run in Docker or locally for development and deployment.

How to use

Connect an MCP client to the endpoint you run locally to begin exchanging MCP commands. The server exposes its MCP endpoint at http://localhost:8081/mcp. You can test the example tool by starting the server, then issuing a test phrase or request through your MCP client and observing the response. To try the built‑in playground or interactive tool testing, start the server in development mode and then use your client to interact with the provided endpoints.

How to install

Prerequisites - Smithery API key obtained from your Smithery account.

uv run dev

For interactive testing after starting in development mode, you can run the playground tool.

uv run playground

Docker convenience for quick local deployment uses standard build/run steps. Build the image from the project root and run the container on port 8081.

docker build -t hello-server .
```

```
docker run --rm -p 8081:8081 --shm-size=1g hello-server

Additional notes

Server listening address and endpoint: the service listens on 0.0.0.0:8081 and serves the MCP endpoint at /mcp. You can connect an MCP client to http://localhost:8081/mcp.

Available tools

playground

Interactive playground tool to test and experiment with MCP commands in a safe environment.