home / mcp / hello mcp server

Hello MCP Server

Provides an MCP endpoint at /mcp with local and Docker run options for development and testing.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "blacklotusdev8-test_m": {
      "url": "http://localhost:8081/mcp",
      "headers": {
        "SMITHERY_API_KEY": "sk_example_abcdef123456"
      }
    }
  }
}

This MCP server provides a programmable interface you can connect to from an MCP client. It exposes an MCP endpoint at /mcp and runs locally on port 8081, enabling you to test, develop, and deploy the server with a clear path from development to production.

How to use

You can connect your MCP client to the server in two primary ways: start a local development instance to experiment and test, or run a Docker container for a portable, production-like environment.

How to install

Prerequisites you need before starting are a Smithery API key to authorize your server and a suitable runtime to execute the server, as indicated by the commands below.

Option 1: Run locally in development mode

Step by step commands

uv run dev

Run interactively for testing

Start an interactive playground environment to test the example tool and explore how the MCP server responds to requests.

uv run playground

Run with Docker

Create a portable container to run the MCP server anywhere Docker is available.

Build the image from the project root

docker build -t hello-server .

Run the container and expose the MCP endpoint on port 8081

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

Notes on connection and runtime

The MCP endpoint is served at the path /mcp. You can connect your MCP client to http://localhost:8081/mcp. When running locally, the server listens on 0.0.0.0:8081 to accept connections from other hosts as needed.

Development

Your server code lives under src/hello_server/server.py. Update capabilities or add new endpoints by editing this file.

Deploy

Ready to move to a hosted environment? Push your code to your chosen hosting provider and redeploy so the MCP endpoint remains accessible at the standard path.