Skip to main content
Glama

Hello World MCP Server

by ai-mcpx
GitHub
Python
MIT License
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP Hello World Server

A simple Hello World MCP (Model Context Protocol) server built with the FastMCP framework in Python using HTTP transport.

Features

  • Multi-language greetings: Say hello in 10 different languages
  • Server information: Get details about the server capabilities
  • Resource serving: Access hello world resources
  • HTTP transport: Uses streamable HTTP instead of stdio for better accessibility
  • FastMCP framework: Built on the modern FastMCP framework
  • Type safety: Uses Pydantic for request/response validation
  • Testing: Includes comprehensive test suite

Installation

Prerequisites

  • Python 3.8 or higher
  • pip package manager

Install dependencies

# Install uv if not already installed curl -LsSf https://astral.sh/uv/install.sh | sh # Create virtual environment and install dependencies uv sync # For development dependencies uv sync --dev
Using pip (Alternative)
# Using pip with requirements.txt pip install -r requirements.txt # Or using the project directly pip install -e . # For development pip install -e ".[dev]"

Usage

Running the Server

# Build and run with docker-compose make docker-build make docker-run # Or manually docker build -t mcp-hello:latest . docker-compose up -d # View logs make docker-logs # Stop the container make docker-stop # Clean up (remove container and image) make docker-clean
Using uv (Development)
# Run the server using uv (HTTP on port 8000) uv run python -m mcp_hello.server # Or using make make run # Custom host/port using environment variables MCP_HOST=localhost MCP_PORT=3000 uv run python -m mcp_hello.server
Using pip installation
# Using the installed script (HTTP on port 8000) mcp-hello # Or running directly python -m mcp_hello.server # Or from the source python mcp_hello/server.py # Custom host/port MCP_HOST=localhost MCP_PORT=3000 python -m mcp_hello.server
Accessing the HTTP Server

Once running, the server will be available at:

  • Default: http://0.0.0.0:8000
  • Local access: http://localhost:8000
  • Custom: Set MCP_HOST and MCP_PORT environment variables

Available Tools

1. say_hello

Generate greetings in different languages.

Parameters:

  • name (str, optional): Name to greet (default: "World")
  • language (str, optional): Language code (default: "en")

Supported languages:

  • en - English
  • es - Spanish
  • fr - French
  • de - German
  • it - Italian
  • pt - Portuguese
  • ru - Russian
  • ja - Japanese
  • ko - Korean
  • zh - Chinese

Example:

{ "tool": "say_hello", "arguments": { "name": "Alice", "language": "es" } }

Response:

{ "greeting": "¡Hola, Alice!", "language": "es", "name": "Alice", "message": "Greeting generated successfully in es" }
2. get_server_info

Get information about the server capabilities.

Parameters: None

Response:

{ "name": "Hello World MCP Server", "version": "1.0.0", "description": "A simple hello world MCP server using FastMCP", "capabilities": [ "greeting generation", "multi-language support", "server information" ], "supported_languages": ["en", "es", "fr", "de", "it", "pt", "ru", "ja", "ko", "zh"] }

Available Resources

1. file://hello-world

A simple hello world message resource.

2. file://server-status

Current server status and available tools/resources.

Development

Project Structure

mcp-hello/ ├── mcp_hello/ │ ├── __init__.py │ ├── server.py # Main MCP server with HTTP transport │ ├── client_example.py # Conceptual client example │ └── http_client_example.py # HTTP client example ├── tests/ │ ├── __init__.py │ └── test_server.py # Test suite ├── docker-compose.yml # Docker orchestration ├── Dockerfile # Container configuration ├── .dockerignore # Docker ignore file ├── bootstrap.sh # Setup script ├── Makefile # Development commands ├── pyproject.toml # Project configuration ├── requirements.txt # Dependencies ├── README.md # This file └── LICENSE # License file

Running Tests

# Run all tests uv run pytest # Run with coverage uv run pytest --cov=mcp_hello # Run specific test file uv run pytest tests/test_server.py # Using make make test
Using pip installation
# Run all tests pytest # Run with coverage pytest --cov=mcp_hello # Run specific test file pytest tests/test_server.py

Code Formatting

# Format code with black uv run black mcp_hello/ tests/ # Lint with ruff uv run ruff check mcp_hello/ tests/ # Auto-fix linting issues uv run ruff check --fix mcp_hello/ tests/ # Using make make format # Format code make lint # Lint code
Using pip installation
# Format code with black black mcp_hello/ tests/ # Lint with ruff ruff check mcp_hello/ tests/ # Auto-fix linting issues ruff check --fix mcp_hello/ tests/

Example Client Usage

HTTP Client Example

The project includes an HTTP client example that demonstrates how to interact with the MCP server over HTTP:

# First, start the server in one terminal uv run python -m mcp_hello.server # Then in another terminal, run the HTTP client example uv run python mcp_hello/http_client_example.py # Or using make make client
Using pip installation
# First, start the server python -m mcp_hello.server # Then run the HTTP client example python mcp_hello/http_client_example.py

Original Client Example

See mcp_hello/client_example.py for a conceptual demonstration of MCP interactions:

uv run python mcp_hello/client_example.py
Using pip installation
python mcp_hello/client_example.py

Configuration

The project uses pyproject.toml for configuration:

  • Build system: Hatchling
  • Dependencies: FastMCP, Pydantic, and aiohttp
  • Development tools: pytest, black, ruff (configured for uv)
  • Entry point: mcp-hello command
  • Virtual environment: Managed by uv
  • Transport: HTTP (streamable) instead of stdio

Environment Variables

The server supports the following environment variables:

  • MCP_HOST: Server host address (default: 0.0.0.0)
  • MCP_PORT: Server port number (default: 8000)

Example:

MCP_HOST=localhost MCP_PORT=3000 uv run python -m mcp_hello.server

Make Commands

The project includes a Makefile with commands for both local development and Docker:

Local Development Commands
make setup-uv # Install uv if not already installed make sync # Create/sync virtual environment make install-dev # Install with development dependencies make test # Run tests make format # Format code make lint # Lint code make run # Run the server (HTTP) make client # Run HTTP client example make clean # Clean build artifacts and venv make help # Show all available commands
Docker Commands
make docker-build # Build Docker image make docker-run # Run container with docker-compose make docker-stop # Stop running container make docker-clean # Remove container and image make docker-logs # Show container logs

Docker Configuration

The project includes comprehensive Docker support:

  • Multi-stage build: Optimized for production with separate build and runtime stages
  • Ubuntu 24.04 base: Latest LTS Ubuntu for stability
  • uv integration: Fast dependency installation during build
  • Security: Non-root user, read-only filesystem, resource limits
  • Health checks: Automatic container health monitoring
  • docker-compose: Production-ready orchestration with logging and resource management

Requirements

For Local Development

  • Python: 3.8 or higher
  • uv: Fast Python package installer and resolver (recommended)
  • Core dependencies:
    • fastmcp>=0.1.0 - FastMCP framework for building MCP servers
    • pydantic>=2.0.0 - Data validation and settings management
    • aiohttp>=3.8.0 - HTTP client for examples and testing

For Docker Deployment

  • Docker: 20.10 or higher
  • docker-compose: 2.0 or higher (for orchestration)
  • Operating System: Ubuntu 24.04 LTS (container base image)

Contributing

  1. Fork the repository
  2. Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh
  3. Create virtual environment: uv sync --dev
  4. Create a feature branch
  5. Make your changes
  6. Run tests: make test or uv run pytest
  7. Format code: make format or uv run black .
  8. Test Docker build: make docker-build
  9. Submit a pull request
Using Docker (Testing Production Build)
  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Build and test with Docker: make docker-build && make docker-run
  5. Check logs: make docker-logs
  6. Stop container: make docker-stop
  7. Submit a pull request
Using pip (Alternative)
  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Run tests: pytest
  5. Format code: black .
  6. Submit a pull request

License

This project is licensed under the terms specified in the LICENSE file.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

A simple MCP server that generates multi-language greetings and provides server information using the FastMCP framework.

  1. Features
    1. Installation
      1. Prerequisites
      2. Install dependencies
    2. Usage
      1. Running the Server
      2. Available Tools
      3. Available Resources
    3. Development
      1. Project Structure
      2. Running Tests
      3. Code Formatting
    4. Example Client Usage
      1. HTTP Client Example
      2. Original Client Example
    5. Configuration
      1. Environment Variables
      2. Make Commands
      3. Docker Configuration
    6. Requirements
      1. For Local Development
      2. For Docker Deployment
    7. Contributing
      1. Using uv (Recommended for Local Development)
      2. Using Docker (Testing Production Build)
      3. Using pip (Alternative)
    8. License

      Related MCP Servers

      • Multichat MCP Server

        kurror
        A
        security
        F
        license
        A
        quality
        A server that enables communication with multiple unichat-based MCP servers simultaneously, allowing users to query different language models and combine their responses for more comprehensive results.
        Last updated -
        2
        JavaScript

      • Streamable HTTP MCP Server

        rmavuluri
        -
        security
        F
        license
        -
        quality
        A simple MCP server implementation that demonstrates streaming capabilities with tools for greetings and notifications, accessible through an interactive command-line client.
        Last updated -
        1
        TypeScript

      • FastMCP Server

        zmzhace
        -
        security
        F
        license
        -
        quality
        A feature-rich Model Context Protocol server built with FastMCP that provides various tools including basic utilities, network services, file operations, encryption tools, and system information functions.
        Last updated -
        Python

      • Greeter MCP Server

        jrmlhermitte
        -
        security
        A
        license
        -
        quality
        A simple demonstration MCP server that provides a greeting functionality when integrated with Gemini CLI.
        Last updated -
        Python
        MIT License
        • Linux
        • Apple

      View all related MCP servers

      New MCP Servers

      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/ai-mcpx/mcp-hello'

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