Skip to main content
Glama
Jasonrve

helloworld-demo-mcp

by Jasonrve

helloworld-demo-mcp

A tiny MCP server over streamable HTTP that exposes one tool: hello_world.

The tool returns a plain English greeting plus the current UTC time.

What is included

  • one MCP tool: hello_world

  • streamable HTTP transport for MCP clients

  • a /healthz endpoint for container probes

  • a Docker image

  • a Helm chart

  • GitHub Actions to build and publish the image to GitHub Container Registry

Related MCP server: simple-greeting-mcp

Local development

python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
pytest

Run the server locally

helloworld-demo-mcp --transport streamable-http --host 127.0.0.1 --port 3000

Or print a short description and exit:

helloworld-demo-mcp --describe

Call the MCP tool

The server exposes its MCP endpoint at /mcp when running in streamable HTTP mode.

Example with an MCP client:

import asyncio

from mcp.client.session import ClientSession
from mcp.client.streamable_http import streamablehttp_client


async def main():
    async with streamablehttp_client("http://127.0.0.1:3000/mcp") as (read_stream, write_stream, _):
        async with ClientSession(read_stream, write_stream) as session:
            await session.initialize()
            result = await session.call_tool("hello_world", {})
            print(result)


asyncio.run(main())

Docker

Build and run the container:

docker build -t helloworld-demo-mcp:local .
docker run --rm -p 3000:3000 helloworld-demo-mcp:local

The health check should then succeed:

curl http://127.0.0.1:3000/healthz

Helm

Render the chart:

helm template helloworld-demo-mcp charts/helloworld-demo-mcp

Install it into a namespace:

helm upgrade --install helloworld-demo-mcp charts/helloworld-demo-mcp \
  --namespace helloworld-demo-mcp \
  --create-namespace

GitHub Container Registry

The GitHub Actions workflow publishes images to:

ghcr.io/Jasonrve/helloworld-demo-mcp

Tags are emitted for the branch SHA and for release tags when you push them.

F
license - not found
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Jasonrve/helloworld-demo-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server