# MCP Weather - Claude Desktop Integration
This project is an example MCP (Model Context Protocol) server designed for use with the Claude Desktop application. It is built to work seamlessly with Claude Desktop.
## Features
- TypeScript-based MCP server
- Weather query via OpenWeather API
- Easy integration with Claude Desktop
## Project Structure
```
.
├── package.json
├── tsconfig.json
├── src/
│ └── index.ts
├── claude_desktop_config.json
```
## Installation
### Requirements
- Node.js (v16 or higher)
- npm
- Claude Desktop (https://desktop.anthropic.com/)
### Setup
1. Clone the repository:
```sh
git clone <repository-url>
cd mcp-weather
```
2. Install dependencies:
```sh
npm install
```
3. Create a `.env` file and fill it as follows:
```env
WEATHER_API_URL=https://api.weatherapi.com/v1/current.json
WEATHER_API_KEY=<your_API_KEY>
```
## Claude Desktop Integration
1. In Claude Desktop, go to `File -> Settings -> Developer -> Edit Config`.
2. Add a block similar to the example below to the config file (edit the file paths to match your own system):
```json
{
"mcpServers": {
"weather": {
"command": "npx",
"args": ["tsx", "C:/your/path/mcp-weather/src/index.ts"],
"cwd": "C:/your/path/mcp-weather"
}
}
}
```
> Note: Replace `C:/your/path/` with the actual path to your project on your computer.
3. Save the settings and restart Claude Desktop.
## .env File and Path Setting
In `src/index.ts`, the path to the `.env` file is set to the project root by default:
```typescript
import dotenv from "dotenv";
dotenv.config({
// Path to your .env file. Edit as needed, e.g.: path: "C:/your/path/.env"
path: ".env", // By default, uses the .env file in the project root
});
```
If your `.env` file is in a different directory, update the `path` parameter accordingly.
## Usage
To start the project:
```sh
npm start
```
Or to run the main file directly:
```sh
npx ts-node src/index.ts
```
## Build
To compile the TypeScript code:
```sh
npm run build
```
## Contributing
Contributions are welcome! Please open issues or submit pull requests for improvements or bug fixes.
## License
MIT License
