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
/healthzendpoint for container probes - a Docker image
- a Helm chart
- GitHub Actions to build and publish the image to GitHub Container Registry
Local development
python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
pytestRun the server locally
helloworld-demo-mcp --transport streamable-http --host 127.0.0.1 --port 3000Or print a short description and exit:
helloworld-demo-mcp --describeCall 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:localThe health check should then succeed:
curl http://127.0.0.1:3000/healthzHelm
Render the chart:
helm template helloworld-demo-mcp charts/helloworld-demo-mcpInstall it into a namespace:
helm upgrade --install helloworld-demo-mcp charts/helloworld-demo-mcp \
--namespace helloworld-demo-mcp \
--create-namespaceGitHub Container Registry
The GitHub Actions workflow publishes images to:
ghcr.io/Jasonrve/helloworld-demo-mcpTags are emitted for the branch SHA and for release tags when you push them.
