Skip to main content
Glama
1XKuson

mcp-hello-test

by 1XKuson
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

mcp-hello-test

Minimal MCP server built to be a deploy target for OneClickMCP. It exists to exercise the deploy pipeline — clone, docker build, run, inject env, expose a port — not to do anything useful.

Why it satisfies the deploy wizard

  • Dockerfile at the repo root (the wizard blocks deploys without one)

  • .env.example at the root, so the wizard prefills the env-var form

  • listens on 0.0.0.0:$PORT, default 3000 — matches the wizard's default internal port

Related MCP server: mcpscope

Transports

Both are served, so it works whichever one the console picks:

Transport

Endpoint

SSE (legacy)

GET /sse, then POST /messages?sessionId=...

Streamable HTTP

POST /mcp (stateless)

Also: GET /health → {"status":"ok"}, and GET / returns the endpoint map.

Tools

Tool

Args

Returns

greet

name?

Hello, <name or $GREETING_NAME>!

add

a, b

their sum

whoami

—

node version, port, uptime, and whether DEMO_API_KEY was injected

whoami is the one that matters for testing: it confirms secrets actually reached the container without printing the secret itself.

Env

Var

Purpose

GREETING_NAME

fallback name for greet

DEMO_API_KEY

dummy secret — whoami reports whether it arrived

PORT

listen port, default 3000

Run locally

npm install
GREETING_NAME=you DEMO_API_KEY=sk-test node server.js
docker build -t mcp-hello-test .
docker run --rm -p 3000:3000 -e DEMO_API_KEY=sk-test mcp-hello-test

Smoke test:

curl -s localhost:3000/health

curl -s -X POST localhost:3000/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Hello World MCP Server

    Auxin-io
    -
    license
    C
    quality
    Not graded
    maintenance
    A simple boilerplate MCP server that provides a basic greeting tool for demonstration purposes. Serves as a starting template for developers to quickly create and deploy custom MCP servers.
    1
    5 npm
    -

  • mcpscope

    sla10132000
    F
    license
    A
    quality
    D
    maintenance
    A simple local MCP server that provides greeting and integer addition tools.
    2
    -

  • hello-world

    isaac-dev0
    A
    license
    Not graded
    quality
    C
    maintenance
    A minimal MCP server deployable to Volken that exposes echo, add, and current_time tools for demonstrating the MCP deployment and usage loop.
    MIT