Skip to main content
Glama
Weather & Stock MCP Server

Weather & Stock MCP Server

by Jeetinida

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

Related MCP server: Weather MCP Server

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      Enables users to get weather alerts and forecasts through natural language interactions. Provides real-time weather information and alert notifications via MCP tools.
      2
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time stock analysis tools including price lookup, comprehensive investment scoring, and company-to-ticker conversion through a MCP interface.
      1
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time financial data including stock quotes, news, and market movers through a secure FastMCP gateway, enabling conversational finance queries.
      17
      -