What is Stocknews Mcp

stocknews-mcp is an MCP (Model Context Protocol) server that provides real-time weather alerts, forecasts, stock prices, historical data, and news through various APIs.

Use cases

Use cases include tracking stock performance, analyzing historical stock trends, receiving weather updates, and staying informed with the latest stock news.

How to use

To use stocknews-mcp, install it via Smithery, set up the necessary environment variables, and start the server. You can then access its features through specific JSON requests.

Key features

Key features include fetching real-time stock prices from Yahoo Finance, retrieving historical stock data, getting stock-related news from NewsAPI, and accessing weather alerts and forecasts from the National Weather Service API.

Where to use

stocknews-mcp can be used in finance, weather forecasting, news aggregation, and any application requiring real-time stock and weather information.

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.