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
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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A Docker-based MCP server that provides current weather information for cities worldwide. Enables AI assistants like Claude to fetch temperature, weather conditions, and humidity data through a standardized interface.

MCP Container Weather Server