-
security-
license-
qualityA minimal TypeScript MCP server that provides a 'hello' tool using the fastMCP framework.
Used as the HTTP client for examples and testing in the MCP server, enabling streamable HTTP transport instead of stdio for better accessibility.
Provides comprehensive Docker support for deploying the MCP server with multi-stage builds, health checks, and production-ready orchestration with logging and resource management.
Used for request/response validation in the MCP server, ensuring type safety when processing tool calls and generating responses.
Integrated for running comprehensive test suites against the MCP server, including coverage reporting.
The primary language for implementing the MCP server, requiring version 3.8 or higher.
Integrated for code linting in the development workflow, with auto-fix capabilities for addressing linting issues.
Used as the base image (Ubuntu 24.04 LTS) for the Docker container deployment, providing stability for the production environment.
MCP Hello World Server
A simple Hello World MCP (Model Context Protocol) server built with the FastMCP framework in Python using HTTP transport.
Prerequisites
Python 3.10 or higher
Install
# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
# Create virtual environment and install dependencies
uv sync
# For development dependencies
uv sync --dev
Usage
Running the Server
Using Docker (Production)
docker build -t mcp-hello:latest .
docker-compose up -d
Using uv (Development)
# Run the server using uv (HTTP on port 8000)
uv run python -m mcp_hello.server
# Custom host/port using environment variables
MCP_HOST=localhost MCP_PORT=3000 uv run python -m mcp_hello.server
Accessing the HTTP Server
Default:
http://0.0.0.0:8000Local access:
http://localhost:8000Custom: Set
MCP_HOSTandMCP_PORTenvironment 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- Englishes- Spanishfr- Frenchde- Germanit- Italianpt- Portugueseru- Russianja- Japaneseko- Koreanzh- 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.2.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.
Example Client Usage
# 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
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
License
This project is licensed under the terms specified in the LICENSE file.
Reference
This server cannot be installed
Related Resources
Related MCP Servers
- -securityFlicense-qualityA simple MCP server implementation that demonstrates streaming capabilities with tools for greetings and notifications, accessible through an interactive command-line client.Last updated -1
- -security-license-qualityA simple MCP server sample that provides a greeting tool which echoes back a personalized Japanese greeting message. Demonstrates basic MCP server implementation using FastMCP framework.Last updated -
- AsecurityFlicenseAqualityA basic MCP server template built with FastMCP that provides simple tools for greeting users, performing math operations, and managing user information. Serves as a starting point for building custom MCP servers with essential functionality examples.Last updated -4