MCP Docker Demo
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCP Docker Demo
A Model Context Protocol (MCP) server implementation with Docker support and a web-based inspector.
π Quick Start
1. Build the Docker Image
docker build -t rak-greet .2. Test the Server (Simple Client)
docker run --rm -i rak-greet python client.py3. Launch Web Inspector (Recommended)
docker run --rm -p 8000:8000 rak-greet python mcp_inspector_web.pyThen open your browser to: http://localhost:8000
Related MCP server: Echo MCP Server
π Project Structure
mcpdocker-demo/
βββ server.py # MCP server with hello-world tool
βββ client.py # Simple test client
βββ mcp_inspector_web.py # Web UI for testing
βββ Dockerfile # Container configuration
βββ requirements.txt # Python dependenciesπ§ What's Inside
MCP Server (server.py)
Implements a simple "hello-world" tool
Accepts a greeting and returns it with " World!" appended
Runs over stdio transport
Includes debug logging
Web Inspector (mcp_inspector_web.py)
Beautiful web interface for testing MCP servers
Lists available tools
Shows tool schemas
Interactive testing with real-time results
Built with FastAPI
Simple Client (client.py)
Command-line MCP client
Connects to server via stdio
Tests the hello-world tool
π οΈ Development
Local Development (without Docker)
# Create virtual environment
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Run server
python server.py
# In another terminal, run client
python client.pyRun Web Inspector Locally
uvicorn mcp_inspector_web:app --host 0.0.0.0 --port 8000 --reloadπ API Reference
Hello World Tool
Name: hello-world
Description: A simple tool that returns a greeting.
Input Schema:
{
"type": "object",
"properties": {
"greeting": {
"type": "string",
"description": "The greeting to return"
}
},
"required": ["greeting"]
}Example:
Input: {"greeting": "Hello"}
Output: "Hello World!"π³ Docker Commands
# Build image
docker build -t rak-greet .
# Run server
docker run --rm -i rak-greet python server.py
# Run client
docker run --rm -i rak-greet python client.py
# Run web inspector
docker run --rm -p 8000:8000 rak-greet python mcp_inspector_web.pyπ Troubleshooting
"Connection closed" Error
This usually means the server failed to start. Check:
Python version (should be 3.11+)
All dependencies installed
Server logs for errors
Port Already in Use
If port 8000 is busy:
docker run --rm -p 8001:8000 rak-greet python mcp_inspector_web.pyThen open: http://localhost:8001
π Learn More
π€ Contributing
Feel free to open issues or submit pull requests!
π License
MIT License - feel free to use this code however you'd like!
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for progressive tool usage at any scale (see https://klavis.ai)
POC MCP server. Tool say_hello returns 'Welcome' (agent -> MCP -> API path).
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA demonstration MCP server that provides basic utility tools including hello world functionality and string reversal operations. Shows how to build and deploy MCP tools using the MCPO orchestrator framework.GPL 3.0
- FlicenseNot gradedqualityDmaintenanceA simple demonstration MCP server that provides an echo tool and resource for learning how to build MCP servers. Serves as a starting point and template for creating custom MCP server implementations.1-
- AlicenseNot gradedqualityDmaintenanceA minimal demonstration server showcasing MCP protocol capabilities including tools, resources, and prompts with basic examples like hello world functionality.MIT
- AlicenseAqualityDmaintenanceA simple Model Context Protocol server that provides a hello world greeting tool, serving as a boilerplate template for quickly creating new MCP servers.110 npmMIT