MCP Docker Demo

# 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 ```bash docker build -t rak-greet . ``` ### 2. Test the Server (Simple Client) ```bash docker run --rm -i rak-greet python client.py ``` ### 3. Launch Web Inspector (Recommended) ```bash docker run --rm -p 8000:8000 rak-greet python mcp_inspector_web.py ``` Then open your browser to: **http://localhost:8000** ## 📁 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) ```bash # 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.py ``` ### Run Web Inspector Locally ```bash 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:** ```json { "type": "object", "properties": { "greeting": { "type": "string", "description": "The greeting to return" } }, "required": ["greeting"] } ``` **Example:** ```json Input: {"greeting": "Hello"} Output: "Hello World!" ``` ## 🐳 Docker Commands ```bash # 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: 1. Python version (should be 3.11+) 2. All dependencies installed 3. Server logs for errors ### Port Already in Use If port 8000 is busy: ```bash docker run --rm -p 8001:8000 rak-greet python mcp_inspector_web.py ``` Then open: http://localhost:8001 ## 📚 Learn More - [Model Context Protocol Documentation](https://modelcontextprotocol.io/) - [MCP Specification](https://spec.modelcontextprotocol.io/) - [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) ## 🤝 Contributing Feel free to open issues or submit pull requests! ## 📄 License MIT License - feel free to use this code however you'd like!