# MCP Server

A ready-to-use implementation of the Model Context Protocol (MCP) that extends Claude with real-time Products/weather data capabilities.

Youtube reference: https://www.youtube.com/watch?v=Y4bpWRLdRoA

## Features

The MCP Product/Weather Server implements below primary tools:

- **get-forecast**: Retrieve current weather conditions and forecasts for any location by latitude/longitude
- **get-alerts**: Check for active weather alerts in any US state
- **get-products**: list all available products in the catalog
- **add-product**: add a new product to the catalog
- **get-product-by-id**: fetch a product by id

Once connected, Claude can:
- Answer questions about current weather conditions
- Provide detailed weather forecasts
- Alert users to severe weather warnings
- Make recommendations based on weather data
- fetch all added products
- add a product to the catalog (name, description, price, quantity)
- fetch a product by id

## Quick Start

### Prerequisites

- Node.js 16+ and npm
- [Claude Desktop](#) <!-- Replace with actual link to Claude Desktop download page -->
- Basic knowledge of TypeScript/JavaScript

- you also need to run spring boot rest apis using application: product-poc

### Installation

1. Clone this repository:
   ```bash
   git clone https://github.com/navgour1989/mcp-server.gitt
   cd mcp-server
   ```

2. Install dependencies:
   ```bash
   npm install
   ```

3. Build the project:
   ```bash
   npm run build
   ```

### Connecting to Claude Desktop

1. Open your Claude Desktop configuration file:
    - Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`
    - Windows: `%AppData%\Claude\claude_desktop_config.json`

2. Add the following configuration (update the path to point to your repository):
   ```json
   {
     "mcpServers": {
       "product": {
         "command": "node",
         "args": [
           "/absolute/path/to/your/mcp-server/build/index.js"
         ]
       }
     }
   }
   ```

3. Restart Claude Desktop

4. Look for the hammer icon in Claude Desktop, indicating that MCP tools are available

### Testing Your Implementation

Try asking Claude these questions:
- "What's the weather like in San Francisco right now?"
- "Are there any weather alerts in Texas today?"
- "What's the forecast for Chicago this weekend?"