MCP Container

A Docker-based Model Context Protocol (MCP) server implementation that provides weather information through a standardized interface.

What is MCP?

The Model Context Protocol (MCP) is a standardized way for AI applications to interact with external tools and data sources. This container provides a weather information service that can be used by Claude and other MCP-compatible AI assistants.

Prerequisites

• Docker Desktop installed and running

  • Download for Windows

  • Download for Mac

  • Download for Linux

• Claude Desktop (for using the MCP server)

  • Download Claude Desktop

• Git (for cloning the repository)

Installation

1. Clone the Repository

git clone https://github.com/Pimmetjeoss/MCP_container.git
cd MCP_container

2. Build the Docker Image

docker build -t mcp-server .

This will create a Docker image with Python 3.11 and all necessary dependencies.

3. Run the Container

docker run -d --name mcp-weather-server mcp-server

The container will start and run the MCP weather server.

Configuration

Connect to Claude Desktop

To use this MCP server with Claude Desktop, add the following configuration to your Claude Desktop settings:

Windows: %APPDATA%\Claude\claude_desktop_config.json Mac/Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "weather": {
      "command": "docker",
      "args": ["exec", "-i", "mcp-weather-server", "python", "/app/weather.py"]
    }
  }
}

After updating the configuration, restart Claude Desktop.

Usage

Once configured, you can ask Claude to get weather information:

• "What's the weather in Amsterdam?"

• "Show me the forecast for New York"

• "Get weather data for Tokyo"

The MCP server will respond with temperature, conditions, and humidity information.

Available Tools

This MCP server provides the following tool:

• get-weather: Get current weather information for any city

  • Input: city (string) - Name of the city

  • Output: Temperature (°C), conditions, and humidity (%)

Docker Commands

View Container Logs

docker logs mcp-weather-server

Stop the Container

docker stop mcp-weather-server

Start the Container

docker start mcp-weather-server

Remove the Container

docker rm -f mcp-weather-server

Rebuild After Changes

docker build -t mcp-server .
docker rm -f mcp-weather-server
docker run -d --name mcp-weather-server mcp-server

Project Structure

mcp_container/
├── Dockerfile              # Docker configuration
├── weather.py             # MCP server implementation
├── requirements.txt       # Python dependencies
├── README.md             # This file
├── QUICK_START.md        # Quick setup guide
└── MCP_CONTAINER_GUIDE.md # Detailed documentation

Documentation

• QUICK_START.md - Fast setup guide to get running quickly

• MCP_CONTAINER_GUIDE.md - Comprehensive guide with examples and troubleshooting

Troubleshooting

Container won't start

• Make sure Docker Desktop is running

• Check if port is not already in use: docker ps

Claude can't connect to MCP server

• Verify the container is running: docker ps

• Check container logs: docker logs mcp-weather-server

• Ensure the config file path is correct for your OS

• Restart Claude Desktop after changing configuration

Permission errors on Windows

• Run Docker Desktop as Administrator

• Make sure WSL2 is properly configured

Contributing

Feel free to submit issues and pull requests to improve this MCP server.

License

This project is open source and available under the MIT License.

Resources

• MCP Documentation

• Docker Documentation

• Claude Desktop