📦

Weather & Stock Data Server

Provide real-time stock prices, historical stock data, stock-related news, and weather alerts and forecasts to enhance your applications with timely financial and weather information. Integrate multiple APIs seamlessly to access comprehensive market and weather insights. Empower your agents with up-to-date data for informed decision-making and alerts.

0 installs

Trust: 34 — Low

Maps

Ask AI about Weather & Stock Data Server

I know everything about Weather & Stock Data Server. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

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

Clone the repository:

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

Install dependencies:
```
npm install
```
Set up environment variables:
Create a .env file and add:
```
NEWS_API_KEY=your_newsapi_key
```
Start the server:
```
npm start
```

Debug

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.