Skip to main content
Glama
mkowalskizoovu

Weather MCP Server

README.md
# Weather MCP Server

An MCP (Model Context Protocol) server that provides temperature conversion tools via HTTP.

## Features

- **transformFahrenheitToCelsius**: Convert temperature from Fahrenheit to Celsius

## Installation

```bash
npm install
```

## Development

```bash
npm run dev
```

## Build

```bash
npm run build
```

## Run

```bash
npm start
```

The server will run on `http://localhost:3000/mcp` by default. You can change the port by setting the `PORT` environment variable.

## Usage

Send POST requests to `/mcp` endpoint with MCP protocol messages.

Example request to call the tool:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "transformFahrenheitToCelsius",
    "arguments": {
      "fahrenheit": 98.6
    }
  }
}
```

## AWS Deployment

This server is ready for AWS Lambda + API Gateway deployment.

### Quick Start

**First deployment:**
```bash
npm run deploy
```

**Update existing deployment:**
```bash
npm run deploy:quick
```

**Delete from AWS:**
```bash
sam delete --stack-name weather-mcp
```

### Prerequisites

- AWS CLI installed and configured (`aws configure`)
- AWS SAM CLI installed
- AWS account with appropriate permissions

See **DEPLOYMENT.md** for detailed setup instructions.

### Cost

Should be **$0** for testing (within AWS free tier: 1M requests/month).