# 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](https://docs.docker.com/desktop/install/windows-install/)
  - [Download for Mac](https://docs.docker.com/desktop/install/mac-install/)
  - [Download for Linux](https://docs.docker.com/desktop/install/linux-install/)
- **Claude Desktop** (for using the MCP server)
  - [Download Claude Desktop](https://claude.ai/download)
- **Git** (for cloning the repository)

## Installation

### 1. Clone the Repository

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

### 2. Build the Docker Image

```bash
docker build -t mcp-server .
```

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

### 3. Run the Container

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

```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
```bash
docker logs mcp-weather-server
```

### Stop the Container
```bash
docker stop mcp-weather-server
```

### Start the Container
```bash
docker start mcp-weather-server
```

### Remove the Container
```bash
docker rm -f mcp-weather-server
```

### Rebuild After Changes
```bash
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](QUICK_START.md)** - Fast setup guide to get running quickly
- **[MCP_CONTAINER_GUIDE.md](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](https://modelcontextprotocol.io/)
- [Docker Documentation](https://docs.docker.com/)
- [Claude Desktop](https://claude.ai/download)