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.