Weather-MCP-Server

A Weather MCP Server that provides weather data using the Model Context Protocol (MCP). Built with TypeScript and runs on Node.js.

Visit Server
Added on 3/28/2025

Weather MCP Server

This is a Weather MCP Server that provides weather data using the Model Context Protocol (MCP). It is built with TypeScript and runs on Node.js.

๐Ÿ“Œ Features

  • Fetches and processes weather data.
  • Uses Model Context Protocol (MCP) SDK.
  • Built with TypeScript for type safety.
  • Configurable via environment variables.

๐Ÿ›  Installation

1๏ธโƒฃ Clone the Repository

git clone https://github.com/your-username/weather-mcp-server.git
cd weather-mcp-server

2๏ธโƒฃ Install Dependencies

npm install

3๏ธโƒฃ Build the Project

npm run build

4๏ธโƒฃ Run the Server

npm start

Alternatively, you can run the compiled JavaScript directly:

node build/index.js

๐Ÿ”ง Configuration

This project uses environment variables for configuration. You can create a .env file in the root directory:

API_KEY=your_weather_api_key
PORT=3000

๐Ÿ“ Scripts

| Command | Description | |---------------|-------------| | npm run build | Compiles TypeScript into JavaScript | | npm start | Runs the compiled server | | npm run lint | Lints TypeScript files using ESLint |

๐Ÿ“ Project Structure

weather-mcp-server/
โ”‚โ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ index.ts       # Main entry point
โ”‚โ”€โ”€ build/             # Compiled JavaScript output
โ”‚โ”€โ”€ package.json       # Project dependencies and scripts
โ”‚โ”€โ”€ tsconfig.json      # TypeScript configuration
โ”‚โ”€โ”€ .eslintrc.js       # ESLint configuration

๐Ÿž Troubleshooting

  • If npm run build doesn't produce output, check TypeScript logs:
    npx tsc --diagnostics
    
  • If Node.js cannot find index.js, ensure build/ contains compiled files:
    ls build/
    
  • If running on Windows, chmod will fail in package.json. Remove chmod 755 build/index.js from the build script.

๐Ÿ“œ License

This project is licensed under the ISC License.


๐Ÿ”ง Developed by Moiz Ghuman