simple mcp
Configuration
View docs{
"mcpServers": {
"abudhu-hello-mcp": {
"url": "http://localhost:8000/mcp",
"headers": {
"HOST": "0.0.0.0",
"PORT": "8000",
"TRANSPORT": "http"
}
}
}
}Hello MCP Server is a lightweight Python-based MCP (Model Context Protocol) server that offers a greeting tool. It supports both local development via stdio and remote access via HTTP, and is ready for containerized deployment with Docker. This guide walks you through usage, installation, configuration, and common deployment scenarios so you can run and test the server quickly.
You connect to the server with an MCP client using either stdio or HTTP transport. In stdio mode, you run the Python process locally and interact directly through your development environment. In HTTP mode, the server exposes an HTTP endpoint at the configured URL, letting remote clients send MCP requests over the web transport. The server includes a greet tool that responds to messages like how are you with I am great.
Practical usage patterns include running the server in stdio during development for fast iteration, and switching to HTTP when you want to test integration with remote clients or UI tools. If you deploy in production, you typically expose the HTTP endpoint behind a reverse proxy for TLS termination and monitoring.
Prerequisites - Python installed on your machine or environment where you plan to run the server - Optional: Docker and Docker Compose if you prefer containerized deployment
Local development setup using stdio mode - Install Python dependencies (assuming you have the server script available): - Start the server directly with Python: - Start the server using an alternative runner if you prefer:
Configuration and runtime options are described below. You can choose stdio for local development or HTTP for remote access. The default transport is stdio, but you can switch to HTTP by setting the TRANSPORT environment variable to http before starting the server.
Environment variables you may encounter - TRANSPORT: Transport mode, values are stdio or http - HOST: Host to bind to (use 0.0.0.0 for container deployments) - PORT: Port to listen on (default 8000 when using HTTP)
Project structure highlights the key files you’ll interact with: the main server script, dependencies, containerization files, and IDE configurations that help you test and develop with MCP.
Responds to greeting messages and returns a friendly response, e.g., 'I am great' when asked how you are.