Weather & Stock MCP Server

Weather & Stock MCP Server 🌦️📉

This project is an MCP (Model Context Protocol) server that provides weather alerts, forecasts, stock prices, historical data, and news using various APIs.

Features 🚀

• 🐼 Fetch real-time stock prices using Yahoo Finance
• 📊 Retrieve historical stock data (daily, weekly, monthly)
• 📰 Get stock-related news from NewsAPI
• 🌦️ Fetch weather alerts and forecasts using the National Weather Service API

Installation & Setup ⚙️

Installing via Smithery

This MCP Server uses latest StreamableHTTP to server MCP client request. To install Weather & Stock Data Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @Jeetinida/stocknews-mcp --client claude

Prerequisites

• Node.js (v18 or higher)
• Git
• An API key for NewsAPI

Steps

1. Clone the repository:

   git clone https://github.com/<your-username>/<repo-name>.git
   cd <repo-name>
   

2. Install dependencies:

   npm install
   

3. Set up environment variables:
   Create a .env file and add:

   NEWS_API_KEY=your_newsapi_key
   

4. Start the server:

   npm start
   

Debug

1. Inspector You can inspect your MCP server using:

   npx @modelcontextprotocol/inspector
   

Usage 🛠️

The MCP server provides the following tools:

Get Stock Price

{
  "tool": "get-stock-price",
  "params": {
    "symbol": "AAPL"
  }
}

Get Historical Stock Data

{
  "tool": "get-historical-data",
  "params": {
    "symbol": "AAPL",
    "startDate": "2024-01-01",
    "endDate": "2024-03-01",
    "interval": "1d"
  }
}

Get News

{
  "tool": "get-news",
  "params": {
    "stockName": "Tesla",
    "startDate": "2024-03-01",
    "endDate": "2024-03-10"
  }
}

Docker

Dockerfile is attached with the project, you will have to set your NEWS_API_KEY and run the following docker command: Docker build:

  docker build -t weather-mcp .

Docker run:

  docker run -d --name {CONTAINER_NAME} --env NEWS_API_KEY={news_api_key} -p 3333:3333 weather-mcp 

Contributing 🤝

Feel free to fork this repo, make changes, and submit a pull request! 🚀

License 🐟

This project is licensed under the MIT License.