stock-market-server

stock-market-server

6

The Stock Market MCP Server is designed to retrieve real-time stock market and company financial data using TypeScript and the Alpha Vantage API. It includes features for fetching stock prices, market reports, and financial statements, and integrates with various platforms using the MCP SDK.

Stock Market MCP Server

A TypeScript-based MCP server for accessing stock market data. It provides real-time stock market information and company financial data through the Alpha Vantage API.

Features

  • get_ticker_price - Fetches real-time stock price for a provided ticker symbol.
  • get_market_report - Offers an overview of the US market status.
  • get_financial_statement - Retrieves financial statements such as income, balance, and cash flow for a provided ticker.
  • get_company_overview - Provides key metrics and basic information for a specific ticker.

Development Setup

  • Install dependencies using npm install.
  • Build the project with npm run build.
  • Use npm run watch for development mode with auto-rebuild.

Installation Instructions

Configure claude_desktop_config.json on both MacOS and Windows to run the server in Claude Desktop.

Debugging

Use the MCP Inspector tool for debugging the server via standard input/output (stdio).

Technology Stack

  • TypeScript
  • Node.js
  • Alpha Vantage API
  • MCP SDK (@modelcontextprotocol/sdk)

Notes

  • Ensure a valid Alpha Vantage API key is available.
  • All API responses return in JSON format.
  • Be aware of the rate limits imposed by the Alpha Vantage API.