Skip to main content
Glama
Sign In
helloworld-demo-mcp

helloworld-demo-mcp

by Jasonrve
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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: hello-world-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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers