Skip to main content
Glama
mikej345

hello-mcp-glama

by mikej345
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

hello-mcp

A deliberately tiny, risk-free MCP server for learning how MCP directory listings work.

Repository: https://github.com/mikej345/hello-mcp

  • No network calls, no API keys, no user data. Every tool is read-only and pure.

  • Runs over both MCP transports: stdio (for "runs from source" listings) and Streamable HTTP (for "hosted endpoint" listings).

Tools

Tool

Input

Returns

get_rule_of_thumb

none

A random engineering rule of thumb

add_numbers

a, b (numbers)

Their sum

get_server_time

none

Current UTC time (a liveness check)

Related MCP server: File System Explorer MCP Server

Run it locally

pip install -r requirements.txt

# stdio (an AI app launches it as a local program)
python server.py

# Streamable HTTP (serves http://localhost:8000/mcp)
MCP_TRANSPORT=streamable-http python server.py

Inspect it with the official MCP Inspector (needs Node.js):

npx @modelcontextprotocol/inspector python server.py

Configuration

Env var

Default

Purpose

MCP_TRANSPORT

stdio

stdio or streamable-http

HOST

0.0.0.0

Bind address for HTTP

PORT

8000

Port for HTTP (most hosts set this for you)

License

MIT

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

Resources

Related MCP Connectors

Related MCP Servers

  • Test MCP Server

    Shahzaibalikhawaja
    A
    license
    Not graded
    quality
    D
    maintenance
    A simple learning-focused MCP server that demonstrates basic functionality with tools for mathematical operations, system information, and email validation, plus sample file resources. Perfect for understanding MCP protocol basics and testing integrations.
    16 npm
    ISC

  • File System Explorer MCP

    akshat12000
    A
    license
    B
    quality
    D
    maintenance
    A beginner-friendly MCP server that enables AI to explore file systems through tools for listing directories, reading files, searching with wildcards, and getting file metadata. Perfect for learning MCP development while providing practical file system interaction capabilities.
    4
    16 npm
    MIT

  • mcp-hardened

    Nu1lstep
    A
    license
    B
    quality
    B
    maintenance
    A deliberately small MCP server that demonstrates security hardening against the OWASP MCP Top 10 with tools for file search, record queries, and document fetching, each defended against path traversal, SQL injection, and SSRF.
    4
    MIT